@sideboard-ai/core 0.1.149 → 0.1.150

package/dist/index.js

@@ -13,6 +13,7 @@ import {
   HOME_BOARD_AGENT_HINT,
   HOME_BOARD_CACHE_TTL_MS,
   LEGACY_REVIEW_REQUEST_PATH,
+  LIVE_TURN_SPAWN_GRACE_MS,
   LONG_RUNNING_SKILL_COMMAND,
   OPTIONAL_SERVICES,
   OPTIONAL_SERVICE_IDS,
@@ -212,7 +213,18 @@ import {
   worktreeCleanupSettings,
   wrapReviewSkillMarkdown,
   writeWorktreeFile
-} from "./chunk-JDYKQ6OI.js";
+} from "./chunk-NUPITVRF.js";
+import {
+  LEGACY_PLAN_FILE_REL,
+  PLAN_FILE_NAME,
+  PLAN_FILE_REL,
+  extractPresentedPlan,
+  isPresentPlanToolName,
+  planFileAbs,
+  readPlanFile,
+  resolvePlanMarkdown,
+  writePlanFile
+} from "./chunk-PTOSP4AH.js";
 import {
   BRIGHTSY_MCP_ALLOWED_TOOLS,
   CLAUDE_MODEL_CATALOG,
@@ -247,6 +259,7 @@ import {
   isBrightsyConnected,
   isBrightsyNdjsonLine,
   isCursorAutoModel,
+  isInternalAgentStatusText,
   isPollWrapperToolName,
   isSessionQuotaLimit,
   isShellToolName,
@@ -294,7 +307,7 @@ import {
   withEventParentId,
   withEventsParentId,
   writeInjectedMcpConfig
-} from "./chunk-PTI5H3RK.js";
+} from "./chunk-SDN4ZYQH.js";
 import {
   brightsyMcpServerName,
   connectBrightsyTeam,
@@ -304,7 +317,7 @@ import {
   listBrightsyAccounts,
   listConnectedBrightsyTeams,
   switchBrightsyAccount
-} from "./chunk-KBWND62T.js";
+} from "./chunk-7F4XE6UG.js";
 import {
   brightsyAccessTokenNeedsRefresh,
   brightsyConfigPath,
@@ -319,7 +332,7 @@ import {
   listWorkspaces,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-3QRGCKYL.js";
+} from "./chunk-HAS5EPBS.js";
 import {
   CLOUD_COORDINATOR_BUSY_REPLY,
   CLOUD_COORDINATOR_STOPPED_REPLY,
@@ -354,7 +367,7 @@ import {
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments,
   takenTeamSlugsForOrchestration
-} from "./chunk-R4JP32P5.js";
+} from "./chunk-AF6O55PJ.js";
 import {
   COORDINATOR_TOOL_PLAYBOOK,
   SLACK_REPLY_FORMATTING,
@@ -363,64 +376,11 @@ import {
   enrichWorkspacesWithGithub,
   ensureGlobalCoordinatorCwd,
   formatWorkspaceInventory
-} from "./chunk-EGDRPA4B.js";
-import {
-  ABLETIME_MCP_PATH,
-  DEFAULT_ABLETIME_HOST,
-  abletimeMcpRequest,
-  abletimeMcpUrl,
-  callAbleTimeTool,
-  createAbleTimeTask,
-  ensureAbleTimeTask,
-  getAbleTimeOrientation,
-  getAbleTimeTask,
-  issueAttachmentForAbleTimeTask,
-  listAbleTimeAssignedIssues,
-  listAbleTimeProjects,
-  listAbleTimeTasks,
-  mapAbleTimeTask,
-  normalizeAbleTimeHost,
-  rewriteAbleTimeError,
-  searchAbleTimeTasks,
-  taskUrl,
-  toAbleTimeIssueInfo,
-  verifyAbleTimeConnection
-} from "./chunk-VZJVKQHH.js";
-import {
-  formatFetchError,
-  httpFetch,
-  setHttpFetchImpl
-} from "./chunk-ELBYOGVA.js";
-import {
-  LEGACY_PLAN_FILE_REL,
-  PLAN_FILE_NAME,
-  PLAN_FILE_REL,
-  extractPresentedPlan,
-  isPresentPlanToolName,
-  planFileAbs,
-  readPlanFile,
-  resolvePlanMarkdown,
-  writePlanFile
-} from "./chunk-QTUESPAW.js";
-import "./chunk-AXQ4ZWHK.js";
-import {
-  AGENT_RUNNER_MAX_OLD_SPACE_MB,
-  applyAgentRunnerHeapEnv,
-  cursorSdkMessageToEvents,
-  parseCursorRunnerLine,
-  preferredCursorCostCents,
-  turnCostUsdFromCursorUsage,
-  withMaxOldSpaceSize
-} from "./chunk-LAFA56WD.js";
-import {
-  caffeinateHoldPath,
-  getCaffeinateHold,
-  isThreadCaffeinated,
-  releaseCaffeinateHoldForThread,
-  setCaffeinateHold
-} from "./chunk-DCOZABNT.js";
+} from "./chunk-NOTANBYC.js";
 import {
   FAMOUS_SOCCER_TEAMS,
+  GITHUB_PR_BODY_MAX_CHARS,
+  GITHUB_PR_BODY_SAFE_CHARS,
   addPrStackLayer,
   allocateTeamName,
   allocateTeamSlug,
@@ -429,6 +389,7 @@ import {
   branchDisplayLabel,
   canonicalizeRepoPath,
   checkoutPrStackLayer,
+  clampGithubPrBody,
   codexSandboxWritableRootsArgs,
   codexUnattendedGitConfigArgs,
   collectTakenTeamSlugs,
@@ -459,9 +420,11 @@ import {
   ghHeadRef,
   ghRepoSelectArgs,
   githubAgentGitEnv,
+  githubHttpsInsteadOfEntries,
   initPrStack,
   isDefaultishSourceRef,
   isDirty,
+  isGhPrBodyTooLongError,
   isGhRateLimitError,
   isInPrStack,
   isPlaceholderBranch,
@@ -505,14 +468,52 @@ import {
   worktreeDisplayLabel,
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath
-} from "./chunk-YP3CSOZ6.js";
+} from "./chunk-ZGFYFVJF.js";
 import {
   ATTACHMENTS_DIR,
   LEGACY_ATTACHMENTS_DIR,
   attachmentsGitignoreBody,
   isWorkspaceScratchPath
-} from "./chunk-FKOIHGKV.js";
+} from "./chunk-WHU7YGWP.js";
+import {
+  ABLETIME_MCP_PATH,
+  DEFAULT_ABLETIME_HOST,
+  abletimeMcpRequest,
+  abletimeMcpUrl,
+  callAbleTimeTool,
+  createAbleTimeTask,
+  ensureAbleTimeTask,
+  getAbleTimeOrientation,
+  getAbleTimeTask,
+  issueAttachmentForAbleTimeTask,
+  listAbleTimeAssignedIssues,
+  listAbleTimeProjects,
+  listAbleTimeTasks,
+  mapAbleTimeTask,
+  normalizeAbleTimeHost,
+  rewriteAbleTimeError,
+  searchAbleTimeTasks,
+  taskUrl,
+  toAbleTimeIssueInfo,
+  verifyAbleTimeConnection
+} from "./chunk-WLV7TRMR.js";
 import {
+  formatFetchError,
+  httpFetch,
+  setHttpFetchImpl
+} from "./chunk-ELBYOGVA.js";
+import "./chunk-AXQ4ZWHK.js";
+import {
+  AGENT_RUNNER_MAX_OLD_SPACE_MB,
+  applyAgentRunnerHeapEnv,
+  cursorSdkMessageToEvents,
+  parseCursorRunnerLine,
+  preferredCursorCostCents,
+  turnCostUsdFromCursorUsage,
+  withMaxOldSpaceSize
+} from "./chunk-HEII7W3Q.js";
+import {
+  FOLLOW_UP_BEHAVIORS,
   GITHUB_GIT_AUTH_MODES,
   HARNESS_ENV_KEYS,
   ISSUE_SOURCE_LABELS,
@@ -538,6 +539,7 @@ import {
   disconnectLinearConnection,
   emptyPublicIntegrations,
   ensureSlackDeviceIdentity,
+  followUpBehavior,
   getAbleTimeAccessToken,
   getAbleTimeHost,
   getDefaultAgent,
@@ -583,10 +585,17 @@ import {
   updateDefaultsSettings,
   updateIntegrationsSettings,
   updateOpencodeSettings
-} from "./chunk-I77RYPOH.js";
+} from "./chunk-4XNSGDXE.js";
 import {
   stripNestedElectronEnv
 } from "./chunk-4TR3HZFT.js";
+import {
+  caffeinateHoldPath,
+  getCaffeinateHold,
+  isThreadCaffeinated,
+  releaseCaffeinateHoldForThread,
+  setCaffeinateHold
+} from "./chunk-DCOZABNT.js";
 import "./chunk-JT7R45JB.js";
 import {
   appendMessage,
@@ -640,6 +649,7 @@ import {
   workspaceSettingsSourceLabel,
   worktreesRoot
 } from "./chunk-QZQEXME2.js";
+import "./chunk-Y4NAPW5I.js";
 import {
   conductorBundledBinDir,
   enrichPathWithNpmGlobalBin,
@@ -653,7 +663,7 @@ import {
   resolveGitDirsForLockRecovery,
   run,
   withExportedPath
-} from "./chunk-DVM4ID64.js";
+} from "./chunk-UFHNSFAS.js";
 
 // src/integrations/github.ts
 async function getGitHubStatus() {
@@ -1053,6 +1063,22 @@ query SideboardAssignedIssues($first: Int!) {
   }
 }
 `;
+var ISSUES_QUERY = `
+query SideboardIssues($first: Int!, $filter: IssueFilter) {
+  viewer { id name }
+  issues(first: $first, orderBy: updatedAt, filter: $filter) {
+    nodes { ${LIST_ISSUE_FIELDS} }
+  }
+}
+`;
+var SEARCH_ISSUES_QUERY = `
+query SideboardSearchIssues($term: String!, $first: Int!, $filter: IssueFilter) {
+  viewer { id name }
+  searchIssues(term: $term, first: $first, includeArchived: false, filter: $filter) {
+    nodes { ${LIST_ISSUE_FIELDS} }
+  }
+}
+`;
 var TEAMS_QUERY = `
 query SideboardTeams {
   viewer { id name }
@@ -1336,19 +1362,76 @@ function normalizePriority(priority) {
   }
   return priority;
 }
-async function listLinearAssignedIssues(opts) {
-  const first = Math.max(1, Math.min(250, opts?.limit ?? 200));
-  const json = await linearGraphql(ASSIGNED_ISSUES_QUERY, { first }, opts);
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function assigneeFilterKey(assignee) {
+  return (assignee ?? "").trim();
+}
+function buildLinearIssueFilter(input) {
+  const filter = {
+    state: { type: { nin: ["completed", "canceled"] } }
+  };
+  const raw = assigneeFilterKey(input?.assignee) || "me";
+  const key = raw.toLowerCase();
+  if (key === "all" || key === "*") return filter;
+  if (key === "unassigned" || key === "none" || key === "null") {
+    filter.assignee = { null: true };
+    return filter;
+  }
+  if (key === "me" || key === "@me") {
+    filter.assignee = { isMe: true };
+    return filter;
+  }
+  if (UUID_RE.test(raw)) {
+    filter.assignee = { id: { eq: raw } };
+    return filter;
+  }
+  filter.assignee = { name: { eqIgnoreCase: raw } };
+  return filter;
+}
+function isAssignedToMe(assignee) {
+  const key = assignee.toLowerCase();
+  return key === "me" || key === "@me";
+}
+function listedLinearIssues(json, nodes) {
   return {
     viewer: {
       id: String(json.viewer?.id ?? ""),
       name: String(json.viewer?.name ?? "")
     },
-    issues: (json.viewer?.assignedIssues?.nodes ?? []).map(
-      (node) => toIssueInfo(mapIssue(node))
-    )
+    issues: (nodes ?? []).map((node) => toIssueInfo(mapIssue(node)))
   };
 }
+async function listLinearIssuesFiltered(opts) {
+  const first = Math.max(1, Math.min(250, opts?.limit ?? 200));
+  const query = opts?.query?.trim() ?? "";
+  const assignee = assigneeFilterKey(opts?.assignee) || (query ? "all" : "me");
+  const filter = buildLinearIssueFilter({ assignee });
+  if (query) {
+    const json2 = await linearGraphql(
+      SEARCH_ISSUES_QUERY,
+      { term: query, first, filter },
+      opts
+    );
+    return listedLinearIssues(json2, json2.searchIssues?.nodes);
+  }
+  if (isAssignedToMe(assignee)) {
+    const json2 = await linearGraphql(
+      ASSIGNED_ISSUES_QUERY,
+      { first },
+      opts
+    );
+    return listedLinearIssues(json2, json2.viewer?.assignedIssues?.nodes);
+  }
+  const json = await linearGraphql(
+    ISSUES_QUERY,
+    { first, filter },
+    opts
+  );
+  return listedLinearIssues(json, json.issues?.nodes);
+}
+async function listLinearAssignedIssues(opts) {
+  return listLinearIssuesFiltered({ ...opts, assignee: "me" });
+}
 async function listLinearIssuesDirect(opts) {
   return (await listLinearAssignedIssues(opts)).issues;
 }
@@ -1468,6 +1551,22 @@ async function validateLinearApiKey(apiKey) {
 }
 
 // src/integrations/issues.ts
+function assigneeKey(assignee) {
+  return (assignee ?? "").trim().toLowerCase();
+}
+function issueMatchesAssignee(issue, assignee, viewerName = "") {
+  const key = assigneeKey(assignee);
+  if (!key || key === "all" || key === "*") return true;
+  const names = [...issue.assignees ?? [], issue.assignee ?? ""].map((name) => name.trim().toLowerCase()).filter(Boolean);
+  if (key === "unassigned" || key === "none" || key === "null") {
+    return names.length === 0;
+  }
+  if (key === "me" || key === "@me") {
+    const me = viewerName.trim().toLowerCase();
+    return Boolean(me && names.includes(me));
+  }
+  return names.includes(key);
+}
 async function listGitHubIssues(repoPath, opts) {
   const limit = Math.max(1, Math.min(1e3, opts?.limit ?? 200));
   const slug = await resolveGithubRepoSlug(repoPath);
@@ -1481,6 +1580,17 @@ async function listGitHubIssues(repoPath, opts) {
     "--state",
     "open"
   ];
+  const query = opts?.query?.trim() ?? "";
+  const assignee = opts?.assignee?.trim() ?? "";
+  const key = assignee.toLowerCase();
+  const searchParts = [];
+  if (query) searchParts.push(query);
+  if (key === "unassigned" || key === "none" || key === "null") {
+    searchParts.push("no:assignee");
+  } else if (key && key !== "all" && key !== "*") {
+    args.push("--assignee", key === "me" || key === "@me" ? "@me" : assignee);
+  }
+  if (searchParts.length) args.push("--search", searchParts.join(" "));
   if (slug) args.push("--repo", slug);
   const { stdout, exitCode } = await gh(args, repoPath, { reject: false });
   if (exitCode !== 0 || !stdout.trim()) return [];
@@ -1518,14 +1628,20 @@ async function githubViewerLogin(repoPath) {
   if (exitCode !== 0) return "";
   return stdout.trim();
 }
-async function listIssues(repoPath) {
+async function listIssues(repoPath, opts) {
   const settings = loadAppSettings();
   const preferredSource = settings.integrations.issueSource ?? "github";
   const linearConnected = isLinearConnected(settings);
   const abletimeConnected = isAbleTimeConnected(settings);
   const source = resolveEffectiveIssueSource(settings);
+  const query = opts?.query?.trim() || void 0;
+  const assignee = opts?.assignee?.trim() || void 0;
   if (source === "linear") {
-    const listed = await listLinearAssignedIssues();
+    const listed = await listLinearIssuesFiltered({
+      assignee,
+      query,
+      limit: opts?.limit
+    });
     return {
       source,
       preferredSource,
@@ -1539,13 +1655,20 @@ async function listIssues(repoPath) {
     };
   }
   if (source === "abletime") {
-    const listed = await listAbleTimeAssignedIssues();
+    const [listed, searched] = await Promise.all([
+      listAbleTimeAssignedIssues(),
+      query ? searchAbleTimeTasks(query) : Promise.resolve(null)
+    ]);
+    const viewerName = listed.viewer.name ?? listed.viewer.id ?? "";
+    const issues2 = (searched ? searched.map(toAbleTimeIssueInfo) : listed.issues).filter(
+      (issue) => issueMatchesAssignee(issue, assignee, viewerName)
+    );
     return {
       source,
       preferredSource,
       linearConnected,
       abletimeConnected,
-      issues: listed.issues,
+      issues: issues2,
       viewer: {
         login: listed.viewer.name,
         name: listed.viewer.name
@@ -1553,7 +1676,7 @@ async function listIssues(repoPath) {
     };
   }
   const [issues, login] = await Promise.all([
-    listGitHubIssues(repoPath),
+    listGitHubIssues(repoPath, { assignee, query, limit: opts?.limit }),
     githubViewerLogin(repoPath)
   ]);
   return {
@@ -1939,7 +2062,7 @@ function lastMessagePreview(messages, max = 160) {
   if (!messages?.length) return null;
   for (let i = messages.length - 1; i >= 0; i--) {
     const text5 = messages[i]?.text?.trim();
-    if (!text5) continue;
+    if (!text5 || isInternalAgentStatusText(text5)) continue;
     const flat = text5.replace(/\s+/g, " ");
     return flat.length > max ? `${flat.slice(0, max)}\u2026` : flat;
   }
@@ -2604,6 +2727,22 @@ function registerLinearTools(server) {
       }
     }
   );
+  server.tool(
+    "linear_search_issues",
+    "Search or list open Linear issues. Not limited to the current user \u2014 pass assignee=unassigned for issues with no owner, assignee=all (default when query is set) for anyone including unassigned, assignee=me for yours, or a user id / name. Optional query uses Linear search (title, identifier, description).",
+    {
+      query: z3.string().optional().describe("Search text (identifier, title, description). Omit to list by assignee only."),
+      assignee: z3.string().optional().describe("me, unassigned, all, a Linear user id, or a display name. Default: all when query is set, otherwise me."),
+      limit: z3.number().int().positive().max(250).optional()
+    },
+    async ({ query, assignee, limit }) => {
+      try {
+        return text3(await listLinearIssuesFiltered({ query, assignee, limit }));
+      } catch (err) {
+        return fail3(err);
+      }
+    }
+  );
   server.tool(
     "linear_get_issue",
     "Get a Linear issue by uuid or identifier (ENG-123). Returns description, comments, relations (blocks/blockedBy/related/duplicate), parent/children, project, cycle, labels, and other metadata.",
@@ -3229,7 +3368,7 @@ async function startMcpServer() {
     );
   }
   try {
-    const { maxConcurrentAgents: maxConcurrentAgents2 } = await import("./app-settings-WJDCJFSY.js");
+    const { maxConcurrentAgents: maxConcurrentAgents2 } = await import("./app-settings-3CHCNIMD.js");
     orch.setMaxConcurrent(maxConcurrentAgents2());
   } catch {
   }
@@ -3274,12 +3413,12 @@ async function startMcpServer() {
         const threads = orch.getThreads(true);
         const lines = threads.map((t) => {
           const repo = t.repoPath === GLOBAL_WORKSPACE_ID ? "Orchestration" : basename(t.repoPath) || t.repoPath;
-          const live = t.status === "running" || t.status === "queued" ? readTurnLive(t.id) : null;
+          const live = orch.threadLooksLive(t) ? readTurnLive(t.id) : null;
           const parent = t.parentThreadId ? `  parent:${t.parentThreadId.slice(0, 8)}` : "";
           const preview = lastMessagePreview(t.messages, 80);
           const previewBit = preview ? `  ${preview}` : "";
           const err = t.lastError ? `  error:${t.lastError.replace(/\s+/g, " ").slice(0, 60)}` : "";
-          const progress = live?.summary ? `  ${live.summary}` : "";
+          const progress = live?.summary && !isInternalAgentStatusText(live.summary) ? `  ${live.summary}` : "";
           return `${t.id.slice(0, 8)}  ${t.status.padEnd(9)}  ${t.agent.padEnd(8)}  ${repo}  ${t.sourceType}:${t.sourceRef}  ${t.title}${parent}${previewBit}${err}  sideboard://thread/${t.id}${t.devPort ? `  http://localhost:${t.devPort}` : ""}${progress}`;
         });
         return {
@@ -3341,7 +3480,9 @@ async function startMcpServer() {
         if (!t) {
           return { content: [{ type: "text", text: `Thread not found: ${ref}` }], isError: true };
         }
-        const live = t.status === "running" || t.status === "queued" ? readTurnLive(t.id) : null;
+        const stillRunning = orch.threadLooksLive(t);
+        const live = stillRunning ? readTurnLive(t.id) : null;
+        const liveSummary = live?.summary && !isInternalAgentStatusText(live.summary) ? live.summary : null;
         const spend = orch.getThreadUsage(t.id);
         const summary = {
           id: t.id,
@@ -3361,8 +3502,8 @@ async function startMcpServer() {
           devPort: t.devPort,
           prUrl: t.prUrl,
           lastError: t.lastError ?? null,
-          stillRunning: t.status === "running" || t.status === "queued",
-          progress: live?.summary ?? (t.status === "queued" ? "Queued \u2014 waiting for a concurrency slot" : null),
+          stillRunning,
+          progress: liveSummary ?? (stillRunning && t.status === "queued" ? "Queued \u2014 waiting for a concurrency slot" : null),
           lastActivityAt: live?.updatedAt ?? null,
           usage: spend.usage,
           lastTurnUsage: spend.lastTurnUsage
@@ -3438,7 +3579,7 @@ async function startMcpServer() {
       thread_id: z5.string().optional().describe("Sideboard thread id when cwd is not the worktree")
     },
     async ({ title, content, thread_id }) => {
-      const { writePlanFile: writePlanFile2 } = await import("./plan-file-6O7G4VPQ.js");
+      const { writePlanFile: writePlanFile2 } = await import("./plan-file-5S5TUNAW.js");
       let root = process.cwd();
       if (thread_id?.trim()) {
         const t = orch.getThread(thread_id.trim());
@@ -3511,7 +3652,7 @@ async function startMcpServer() {
     registerAbleTimeTools(server);
     registerScheduleTools(server);
     const { getCaffeinateHold: getCaffeinateHold2, setCaffeinateHold: setCaffeinateHold2 } = await import("./caffeinate-hold-X3JNPR42.js");
-    const { resolveNewThreadOptions: resolveNewThreadOptions2, resolveThreadDefaults: resolveThreadDefaults2 } = await import("./app-settings-WJDCJFSY.js");
+    const { resolveNewThreadOptions: resolveNewThreadOptions2, resolveThreadDefaults: resolveThreadDefaults2 } = await import("./app-settings-3CHCNIMD.js");
     const accountDefaults = resolveThreadDefaults2();
     const accountDefaultsHint = `Account defaults: agent=${accountDefaults.agent}, model=${accountDefaults.model?.trim() || "Auto"}, effort=${accountDefaults.effort}`;
     server.tool(
@@ -3719,7 +3860,7 @@ async function startMcpServer() {
     );
     server.tool(
       "wait_for_turn",
-      "Wait until the thread finishes its current/queued turn, or return early with a live progress snapshot. MCP clients often kill tools around 60s, so this returns within 45s even while the child is still working. If stillRunning is true, progress is tools/thinking (or \u201Cqueued, waiting for a concurrency slot\u201D if it has not started). Call wait_for_turn again. Do not send a check-in prompt, force_stop, or assume a hang. On status error, lastError/text is the failure. On status stopped or broken, the child did not finish \u2014 resume with send_to_thread or tell the user; do not treat that as success. When finished, usage is the last agent turn\u2019s tokens + costUsd (when the provider reported cost).",
+      "Wait until the thread finishes its current/queued turn, or return early with a live progress snapshot. MCP clients often kill tools around 60s, so this returns within 45s even while the child is still working. stillRunning is the source of truth \u2014 if false, the child is not working (do not say it is waiting for a gate). If stillRunning is true, progress is tools/thinking (or \u201Cqueued, waiting for a concurrency slot\u201D if it has not started). Call wait_for_turn again. Do not send a check-in prompt, force_stop, or assume a hang. On status error, lastError/text is the failure. On status stopped or broken, the child did not finish \u2014 resume with send_to_thread or tell the user; do not treat that as success. When finished, usage is the last agent turn\u2019s tokens + costUsd (when the provider reported cost).",
       {
         ref: z5.string(),
         timeoutMs: z5.number().optional()
@@ -3911,7 +4052,7 @@ async function startMcpServer() {
     );
     server.tool(
       "ask_git",
-      "Commit & push, open a draft PR, resolve conflicts, or merge \u2014 same actions as the desktop git buttons. When the worktree is clean, Sideboard pushes / opens the PR itself (HTTPS via `gh` if SSH is missing). When dirty, queues the worktree agent to commit; then wait_for_turn (loop while stillRunning). Pass a worktree thread ref (not the orchestrator). action=merge only when the user explicitly asked to merge that PR. Do not run git or gh from the orchestration cwd.",
+      "Commit & push, open a draft PR, resolve conflicts, or merge \u2014 same actions as the desktop git buttons. When the worktree is clean, Sideboard pushes / opens the PR itself (HTTPS via `gh` even when origin is SSH / Settings \u2192 Git is SSH). When dirty, queues the worktree agent to commit; then wait_for_turn (loop while stillRunning). Pass a worktree thread ref (not the orchestrator). action=merge only when the user explicitly asked to merge that PR. Do not run git or gh from the orchestration cwd. If this tool errors that the GraphQL/PR body is too long, the branch is already pushed \u2014 have the worktree agent retry `gh pr create --body-file` with a short description (GitHub limit 65,536 characters). Do not invent SSH/auth failures from that error.",
       {
         ref: z5.string().describe("Worktree thread id/ref"),
         action: z5.enum(AGENT_GIT_ACTIONS).describe(
@@ -3936,8 +4077,26 @@ async function startMcpServer() {
             ]
           };
         } catch (err) {
-          const message = err instanceof Error ? err.message : String(err);
-          return { content: [{ type: "text", text: message }], isError: true };
+          const raw = err instanceof Error ? err.message : String(err);
+          const message = formatGhLandError(raw);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(
+                  {
+                    error: true,
+                    action,
+                    lastError: message,
+                    hint: /body is too long/i.test(message) ? "Branch is already pushed. send_to_thread so the worktree agent runs gh pr create --draft -R <origin> --body-file <short.md>. Keep the description short." : void 0
+                  },
+                  null,
+                  2
+                )
+              }
+            ],
+            isError: true
+          };
         }
       }
     );
@@ -4332,11 +4491,15 @@ async function startMcpServer() {
     );
     server.tool(
       "list_issues",
-      "List issues from Sideboard Account connections (Linear, AbleTime MCP, or GitHub Issues; falls back to GitHub when the preferred tracker is not connected). Linear/AbleTime are account-wide; GitHub Issues are scoped to repoPath from list_workspaces. When AbleTime is the issue source and work has no ticket, call abletime_ensure_task (or create_thread from the default branch \u2014 Sideboard auto-creates a task to track against). Prefer list_board for Home columns. Then create_thread with sourceType=ticket.",
-      { repoPath: z5.string() },
-      async ({ repoPath }) => {
+      "List or search issues from Sideboard Account connections (Linear, AbleTime MCP, or GitHub Issues; falls back to GitHub when the preferred tracker is not connected). Linear defaults to issues assigned to you; pass assignee=unassigned for no owner, assignee=all for everyone (including unassigned), or a user id / GitHub login. Optional query searches title/identifier. Linear/AbleTime are account-wide; GitHub Issues are scoped to repoPath from list_workspaces. Prefer linear_search_issues when Linear is connected and you need unassigned or other people's tickets. When AbleTime is the issue source and work has no ticket, call abletime_ensure_task (or create_thread from the default branch \u2014 Sideboard auto-creates a task to track against). Prefer list_board for Home columns. Then create_thread with sourceType=ticket.",
+      {
+        repoPath: z5.string(),
+        query: z5.string().optional().describe("Search title, identifier, or description"),
+        assignee: z5.string().optional().describe("me (Linear default), unassigned, all, a user id, or a GitHub login")
+      },
+      async ({ repoPath, query, assignee }) => {
         const root = await resolveRepoRoot(repoPath);
-        const result = await listIssues(root);
+        const result = await listIssues(root, { query, assignee });
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
       }
     );
@@ -6656,7 +6819,10 @@ export {
   DEFAULT_ABLETIME_HOST,
   DEFAULT_WORKTREE_SORT,
   FAMOUS_SOCCER_TEAMS,
+  FOLLOW_UP_BEHAVIORS,
   GITHUB_GIT_AUTH_MODES,
+  GITHUB_PR_BODY_MAX_CHARS,
+  GITHUB_PR_BODY_SAFE_CHARS,
   GLOBAL_WORKSPACE_ID,
   HARNESS_ENV_KEYS,
   HOME_BOARD_CACHE_TTL_MS,
@@ -6668,6 +6834,7 @@ export {
   LINEAR_OAUTH_PORT,
   LINEAR_OAUTH_REDIRECT,
   LINEAR_OAUTH_SCOPES,
+  LIVE_TURN_SPAWN_GRACE_MS,
   LONG_RUNNING_SKILL_COMMAND,
   LinearOAuthCancelledError,
   MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS,
@@ -6757,6 +6924,7 @@ export {
   buildCodeRefAttachment,
   buildDiffCommentAttachment,
   buildForkTranscriptAttachment,
+  buildLinearIssueFilter,
   buildPastedTextAttachment,
   buildPathRefAttachment,
   buildReviewRequestAttachment,
@@ -6774,6 +6942,7 @@ export {
   checkoutPrStackLayer,
   childEnvWithAppSettings,
   claimDesktopHost,
+  clampGithubPrBody,
   classifyWorktreeColumn,
   claudeAdapter,
   claudeChromeEnabled,
@@ -6878,6 +7047,7 @@ export {
   fireSchedule,
   flattenTurnInput,
   flipLinearRelationType,
+  followUpBehavior,
   forkChatTab,
   forkMessageSlice,
   forkThreadWorktree,
@@ -6956,6 +7126,7 @@ export {
   ghRepoSelectArgs,
   git,
   githubAgentGitEnv,
+  githubHttpsInsteadOfEntries,
   globalAgentCwd,
   groupHomeBoardWorktrees,
   handleSlackInbound,
@@ -6992,6 +7163,7 @@ export {
   isDefaultishSourceRef,
   isDesktopHostAlive,
   isDirty,
+  isGhPrBodyTooLongError,
   isGhRateLimitError,
   isGlobalRepoPath,
   isGlobalThread,
@@ -6999,6 +7171,7 @@ export {
   isImageFilePath,
   isInPrStack,
   isInboundForThisDesktop,
+  isInternalAgentStatusText,
   isIssueSourceConnected,
   isLinearConnected,
   isLinearOAuthCancelled,
@@ -7025,6 +7198,7 @@ export {
   isThreadRecordFile,
   isWorkspaceScratchPath,
   issueAttachmentForAbleTimeTask,
+  issueMatchesAssignee,
   issueSourceLabel,
   lastRequestOccupancy,
   latestPendingPlanQuestions,
@@ -7052,6 +7226,7 @@ export {
   listLinearAssignedIssues,
   listLinearIssues,
   listLinearIssuesDirect,
+  listLinearIssuesFiltered,
   listLinearTeams,
   listModelsForAgent,
   listOpencodeModels,