@sideboard-ai/core 0.1.139 → 0.1.143

package/dist/{chunk-ZCLHAOFR.js → chunk-KP4OJUPH.js}

@@ -18,13 +18,13 @@ import {
   stripBrightsyNdjsonNoise,
   sumUsageList,
   toolDescription
-} from "./chunk-CDJISVKN.js";
+} from "./chunk-VHTIHOHE.js";
 import {
   addWorkspace,
   ensureWorkspace,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-SSBM4GZX.js";
+} from "./chunk-HC5N3BDL.js";
 import {
   assertOrchestratorCapableAgent,
   attachmentsFromWorktreePaths,
@@ -41,14 +41,17 @@ import {
   persistPendingFileAttachments,
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments
-} from "./chunk-E2RE7P2S.js";
+} from "./chunk-R2W7A2UO.js";
 import {
   SLACK_REPLY_FORMATTING,
   coordinatorSystemPrompt,
   coordinatorTurnReminder,
   enrichWorkspacesWithGithub,
   ensureGlobalCoordinatorCwd
-} from "./chunk-7SYFWPOZ.js";
+} from "./chunk-UG5N7ET3.js";
+import {
+  httpFetch
+} from "./chunk-ELBYOGVA.js";
 import {
   extractPresentedPlan,
   readPlanFile,
@@ -65,12 +68,13 @@ import {
   looksLikeAgentFailureMessage,
   looksLikeInvalidAgentSession,
   looksLikeV8Oom,
+  packagedMcpDir,
   pushTurnStderr,
   shouldFeedErrorBackToAgent,
   shouldRetryFailedAgentTurn,
   summarizeTurnStderr,
   turnFailChatText
-} from "./chunk-FSCQXMGI.js";
+} from "./chunk-WT5HSFOU.js";
 import {
   releaseCaffeinateHoldForThread
 } from "./chunk-DCOZABNT.js";
@@ -118,7 +122,7 @@ import {
   withRepoGitLock,
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath
-} from "./chunk-DKXZCIB2.js";
+} from "./chunk-O3JEC2UJ.js";
 import {
   ATTACHMENTS_DIR,
   LEGACY_ATTACHMENTS_DIR
@@ -135,9 +139,10 @@ import {
   resolveNewThreadOptions,
   resolveThreadDefaults,
   resolveVaultKey,
+  saveAppSettings,
   updateAdvancedSettings,
   writeSecureJson
-} from "./chunk-GJBHOJCZ.js";
+} from "./chunk-I77RYPOH.js";
 import {
   stripNestedElectronEnv
 } from "./chunk-4TR3HZFT.js";
@@ -339,7 +344,7 @@ function slackTokenFor(ws, kind = "read") {
     const token2 = ws.user_token?.trim();
     if (!token2) {
       throw new Error(
-        `Slack search needs a user token for ${ws.team_name}. Reconnect via Account \u2192 Slack (browser) or paste an xoxp- token.`
+        `Slack search needs a user token for ${ws.team_name}. Reconnect via Settings \u2192 Remote \u2192 Slack (browser) or paste an xoxp- token.`
       );
     }
     return token2;
@@ -354,7 +359,7 @@ function requireSlackWorkspace(teamId) {
   const ws = getSlackWorkspace(teamId);
   if (!ws) {
     const connected = listSlackWorkspaces();
-    const hint = connected.length === 0 ? "Connect a workspace in Account \u2192 Slack workspaces." : `Connected: ${connected.map((t) => `${t.team_name} (${t.team_id})`).join(", ")}`;
+    const hint = connected.length === 0 ? "Connect a workspace in Settings \u2192 Remote \u2192 Slack." : `Connected: ${connected.map((t) => `${t.team_name} (${t.team_id})`).join(", ")}`;
     throw new Error(`Unknown Slack team_id "${teamId}". ${hint}`);
   }
   return ws;
@@ -448,7 +453,7 @@ async function continueSourceThread(threadId, prompt) {
       await continueOnReply(threadId, prompt);
       return;
     }
-    const { getOrchestrator: getOrchestrator2 } = await import("./orchestrator-WEFXUHFX.js");
+    const { getOrchestrator: getOrchestrator2 } = await import("./orchestrator-VIFXOHF4.js");
     await getOrchestrator2().send(threadId, prompt);
   } catch {
   }
@@ -708,7 +713,7 @@ async function pollSlackOutboundWatches(opts) {
 }
 
 // src/orchestrator/orchestrator.ts
-import { existsSync as existsSync15 } from "fs";
+import { existsSync as existsSync16 } from "fs";
 
 // src/agents/spawn.ts
 import { createInterface } from "readline";
@@ -728,9 +733,9 @@ async function spawnAgentTurn(thread, input, onEvent) {
       `Cannot spawn ${thread.agent}: thread ${thread.id} has no worktreePath`
     );
   }
-  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-ZDYKHQ4O.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-NG7SU3GV.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-43O6EPA2.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-2LD3C74O.js");
     ensureGlobalCoordinatorCwd2(
       isOrchestratorThread(thread) ? { orchestratorThreadId: thread.id } : void 0
     );
@@ -1008,6 +1013,15 @@ function estimateOccupancyTokens(messages) {
 function threadHasCompactedContext(messages) {
   return messages.some((m) => m.role === "summary");
 }
+function forwardOccupancyTokens(messages, usage, windowTokens = 1e6) {
+  const estimated = estimateOccupancyTokens(messages);
+  if (threadHasCompactedContext(messages) && estimated > 0) return estimated;
+  if (usage) {
+    const last = contextTokens(usage);
+    if (last > 0 && last <= windowTokens) return last;
+  }
+  return estimated;
+}
 function forwardContextUsage(usage, messages) {
   if (!usage) return null;
   if (!threadHasCompactedContext(messages)) return usage;
@@ -1243,6 +1257,71 @@ function buildSessionSeed(messages, opts) {
     "Continue from this context. Do not repeat the summary unless asked."
   ].join("\n");
 }
+var BRIGHTSY_SUMMARIZE_CONTEXT_TOOL = "summarize_context";
+function extractBrightsyContextSummary(result) {
+  if (!result?.trim()) return null;
+  const trimmed = result.trim();
+  const lower = trimmed.toLowerCase();
+  if (lower.startsWith("context summarization failed") || lower.startsWith("nothing to summarize") || lower.startsWith("no messages found") || lower.startsWith("messages are required") || lower.startsWith("agent id is required")) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      if (parsed.error != null && typeof parsed.context_summary !== "string") {
+        return null;
+      }
+      if (typeof parsed.context_summary === "string" && parsed.context_summary.trim()) {
+        return parsed.context_summary.trim();
+      }
+      return null;
+    }
+  } catch {
+  }
+  if (trimmed.includes('"error"') && !trimmed.includes("context_summary")) {
+    return null;
+  }
+  return trimmed;
+}
+function findLastBrightsyContextSummary(messages) {
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const message = messages[i];
+    if (message?.role !== "agent") continue;
+    for (const part of message.parts ?? []) {
+      if (part.type !== "tool" || part.name !== BRIGHTSY_SUMMARIZE_CONTEXT_TOOL) {
+        continue;
+      }
+      if (part.status === "error") continue;
+      const text = extractBrightsyContextSummary(part.result);
+      if (text) return { index: i, text };
+    }
+  }
+  return null;
+}
+function messagesSinceLastBrightsyContextSummary(messages) {
+  const match = findLastBrightsyContextSummary(messages);
+  if (!match) return messages;
+  return messages.slice(match.index + 1);
+}
+function buildBrightsySessionSeed(messages) {
+  const match = findLastBrightsyContextSummary(messages);
+  const tail = match ? messages.slice(match.index + 1) : messages;
+  const body = formatMessagesAsTranscript(tail, { tools: "none" });
+  if (!match && !body.trim()) return null;
+  const blocks = [
+    "Sideboard conversation context (restored after compaction or a new session):",
+    ""
+  ];
+  if (match) {
+    blocks.push(`## Prior summary
+${match.text}`, "");
+  }
+  if (body.trim()) {
+    blocks.push(body, "");
+  }
+  blocks.push("Continue from this context. Do not repeat the summary unless asked.");
+  return blocks.join("\n");
+}
 function applyCompaction(messages, summaryText, thresholds = {}) {
   const { older, recent } = splitForCompaction(messages, thresholds);
   if (older.length === 0) return messages;
@@ -2860,7 +2939,7 @@ async function createThread(input, _onSetupLine) {
   });
   await requireAgent(resolved.agent);
   if (input.cowboy) {
-    const { cowboyModeEnabled } = await import("./app-settings-U5RZKUXG.js");
+    const { cowboyModeEnabled } = await import("./app-settings-WJDCJFSY.js");
     if (!cowboyModeEnabled()) {
       throw new Error(
         "Cowboy mode is off. Enable it in Settings \u2192 Advanced."
@@ -2916,7 +2995,7 @@ async function createThread(input, _onSetupLine) {
   let sourceIsFork = false;
   if (!input.cowboy && sourceType === "branch" && (!sourceRef || sourceRef === "HEAD" || sourceRef === "default")) {
     if (isAbleTimeConnected() && getIssueSource() === "abletime") {
-      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-DDTV7WO3.js");
+      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-QEVAE67D.js");
       const task = await ensureAbleTimeTask({
         title: title?.trim() || "Untitled work",
         description: input.prompt?.trim() || void 0
@@ -2989,7 +3068,7 @@ async function createThread(input, _onSetupLine) {
   return readThread(thread.id) ?? thread;
 }
 async function listLinearIssues(agent, repoPath) {
-  const { getAdapter: getAdapter2 } = await import("./agents-665S7Z3R.js");
+  const { getAdapter: getAdapter2 } = await import("./agents-E5AAMHDY.js");
   await requireAgent(agent, { requireLinear: true });
   const adapter = getAdapter2(agent);
   if (!adapter.listLinearIssues) {
@@ -3386,7 +3465,7 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-ALCTB65T.js");
+  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-PU5YHQ7Z.js");
   await ensureWorkspace2(repoPath);
   return thread;
 }
@@ -4729,6 +4808,93 @@ async function confirmLand(thread, opts) {
 import { existsSync as existsSync12, readdirSync as readdirSync4, readFileSync as readFileSync9, statSync as statSync3 } from "fs";
 import { homedir } from "os";
 import { join as join11 } from "path";
+
+// src/skills/bundled/long-running.ts
+var LONG_RUNNING_SKILL_COMMAND = "long-running";
+var LONG_RUNNING_SKILL_NAME = "long-running";
+var BUNDLED_LONG_RUNNING_PATH = "bundled:long-running";
+var LONG_RUNNING_SKILL_DESCRIPTION = "Detach and wait on any long worktree job (pack, test, deploy) so a new chat turn does not SIGTERM it, and the human does not have to poll. Use when a command may run more than ~30s, or the user mentions wait / status / aborted builds.";
+var LONG_RUNNING_SKILL_BODY = `# Long-running jobs
+
+A Sideboard or Cursor **worktree turn** SIGTERMs the agent shell (and its process group) when the user sends another message or the turn is interrupted. \`block_until_ms: 0\` is not enough \u2014 the child stays in that group.
+
+Do **not** ask the human to check back. Detach, then **wait** in 45s slices (same idea as MCP \`wait_for_turn\`) until \`stillRunning\` is false.
+
+## Tool
+
+Use the helper from the Sideboard playbook \u2014 an absolute \`node "\u2026" start\` path injected each turn. If this worktree has \`scripts/detached-job.js\`, that is the same tool.
+
+\`\`\`bash
+# Start (exits in ~1s; job survives this turn)
+node <detached-job.js> start <id> -- <command> [args...]
+
+# Wait \u2014 returns within ~45s even if the job is still going
+node <detached-job.js> wait <id>
+
+# Block until the process exits (humans / a turn that will not be interrupted)
+node <detached-job.js> wait <id> --until-done
+
+node <detached-job.js> status <id>
+\`\`\`
+
+\`<id>\` is kebab-case (\`mac-release\`, \`core-test\`, \`fly-deploy\`). State is \`.sideboard/detached-jobs/<id>/\` (local scratch).
+
+Wait JSON:
+
+- \`stillRunning: true\` \u2192 exit 2 \u2192 **call wait again**. Progress is in \`progress\` / \`phase\`. Do not start a second job. Do not ping the user.
+- \`ok: true\` \u2192 exit 0 \u2192 continue the rest of the task.
+- \`failed: true\` \u2192 exit 1 \u2192 read \`progress\`, fix, start **once**.
+
+## Sideboard UI (append-only log)
+
+The side column **is** the live view. Use \`present_artifact\` **\`type=log\`** with a stable \`artifact_id\` (the job id). Each call **appends** \u2014 send only \`delta\` from wait JSON, not the full log and not HTML.
+
+\`\`\`
+present_artifact
+  title: <short title>
+  type: log
+  artifact_id: <id>
+  content: <wait.delta>          # new lines only; empty is ok
+  status: running | ok | failed  # from wait.status
+  phase: <wait.phase>
+\`\`\`
+
+After **start**, present once (\`status=running\`, empty or first lines). After **every wait**, present the same id with \`content=delta\`. Do **not** dump the log in chat. Do **not** also fence HTML.
+
+Ad-hoc pid/log (legacy or another tool\u2019s files):
+
+\`\`\`bash
+node <detached-job.js> wait --pid-file FILE --log-file FILE [--ok-pattern TEXT]
+\`\`\`
+
+## Agent loop
+
+1. \`start\` once. If JSON says \`already-running\`, do not start again.
+2. Immediately \`present_artifact\` \`type=log\` (same \`artifact_id\`, \`status=running\`) \u2014 the human should see **working** in the side column, not a \u201Ccheck back later\u201D message.
+3. Loop \`wait\` (use \`--timeout-ms 15000\` for a livelier pane). After each slice, \`present_artifact\` the same id with \`content=delta\` only.
+4. On \`ok\`, present once more (\`status=ok\`, last \`delta\`) and finish the task. On \`failed\`, fix from the log.
+
+Never tell the user \u201Csay status when it\u2019s done.\u201D You wait.
+`;
+
+// src/skills/discover.ts
+var BUNDLED_SKILL_PREFIX = "bundled:";
+function bundledSkills() {
+  return [
+    {
+      id: BUNDLED_LONG_RUNNING_PATH,
+      name: LONG_RUNNING_SKILL_NAME,
+      command: LONG_RUNNING_SKILL_COMMAND,
+      description: LONG_RUNNING_SKILL_DESCRIPTION.slice(0, 240),
+      path: BUNDLED_LONG_RUNNING_PATH,
+      source: "bundled"
+    }
+  ];
+}
+function bundledSkillBody(id) {
+  if (id === LONG_RUNNING_SKILL_COMMAND) return LONG_RUNNING_SKILL_BODY;
+  return null;
+}
 function toCommand(name) {
   return name.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
@@ -4846,7 +5012,13 @@ function discoverSkills(worktreePath) {
     scanSkillsDir(abs, "user", collected);
   }
   scanClaudePluginSkills(join11(home, ".claude/plugins"), collected);
-  const rank = { workspace: 0, user: 1, cli: 2 };
+  collected.push(...bundledSkills());
+  const rank = {
+    workspace: 0,
+    user: 1,
+    cli: 2,
+    bundled: 3
+  };
   const byCommand = /* @__PURE__ */ new Map();
   for (const skill of collected) {
     const prev = byCommand.get(skill.command);
@@ -4857,6 +5029,14 @@ function discoverSkills(worktreePath) {
   return [...byCommand.values()].sort((a, b) => a.command.localeCompare(b.command));
 }
 function readSkillBody(skillPath, maxChars = 12e3) {
+  if (skillPath.startsWith(BUNDLED_SKILL_PREFIX)) {
+    const body = bundledSkillBody(skillPath.slice(BUNDLED_SKILL_PREFIX.length));
+    if (body) {
+      return body.length > maxChars ? `${body.slice(0, maxChars)}
+
+\u2026(truncated)` : body;
+    }
+  }
   const raw = readFileSync9(skillPath, "utf8");
   if (raw.startsWith("---")) {
     const end = raw.indexOf("\n---", 3);
@@ -4950,8 +5130,39 @@ function expandComposerPrompt(worktreePath, prompt, opts) {
 }
 
 // src/agents/instructions.ts
-import { existsSync as existsSync13, readFileSync as readFileSync10, statSync as statSync4 } from "fs";
-import { join as join12 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync10, statSync as statSync4 } from "fs";
+import { join as join13 } from "path";
+
+// src/skills/detached-job-path.ts
+import { existsSync as existsSync13 } from "fs";
+import { dirname as dirname4, join as join12 } from "path";
+import { fileURLToPath } from "url";
+function packagedDetachedJobPath() {
+  const dir = packagedMcpDir();
+  if (!dir) return null;
+  const script = join12(dir, "scripts", "detached-job.js");
+  return existsSync13(script) ? script : null;
+}
+function resolveDetachedJobScript() {
+  const packaged = packagedDetachedJobPath();
+  if (packaged) return packaged;
+  let dir = dirname4(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 8; i++) {
+    const candidate = join12(dir, "scripts", "detached-job.js");
+    if (existsSync13(candidate)) return candidate;
+    const parent = dirname4(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+function formatDetachedJobInvoke(scriptPath) {
+  const resolved = scriptPath === void 0 ? resolveDetachedJobScript() : scriptPath;
+  if (resolved) return `node ${JSON.stringify(resolved)}`;
+  return "node scripts/detached-job.js";
+}
+
+// src/agents/instructions.ts
 function normPath(p) {
   return p.replace(/\/+$/, "");
 }
@@ -5059,6 +5270,7 @@ function formatWorktreeReminder() {
 function formatProcessGuideDirective() {
   return [
     "Process guides (recurring work only):",
+    "- Long jobs (pack, test, deploy, anything that may run more than ~30s): Sideboard always provides `/long-running`. Detach and wait \u2014 do not ask the human to poll.",
     "- If `.claude/skills/graph-engineering/SKILL.md` exists, follow it (`/graph-engineering`) for migrations, ports, batch fixes, and other fan-out. Judge first; state on disk; grow the rulebook; do not patch around it.",
     "- If this same shape of work will happen again, write `.claude/skills/<kebab-name>/SKILL.md` in this worktree (Claude Code project skill). Sideboard `/name`, Claude Code, and `attach` all load that path. Do not leave the method only in chat.",
     "- Merge-readiness notes: create or edit `.claude/skills/review/SKILL.md` and commit it. That file is allowed. Do not use `.sideboard/review.md` for new notes (legacy; setup copies it into the skill).",
@@ -5066,6 +5278,23 @@ function formatProcessGuideDirective() {
     "- Skip a guide for a one-off. If a matching skill exists, follow it. Same miss twice \u2192 edit the skill, do not patch around it."
   ].join("\n");
 }
+function formatLongRunningDirective(opts) {
+  const invoke = formatDetachedJobInvoke(opts?.scriptPath);
+  return [
+    "Long-running jobs (mandatory when a command may run more than ~30s):",
+    "A Sideboard worktree turn SIGTERMs the agent shell (and its process group) when the user sends another message or the turn is interrupted. `block_until_ms: 0` is not enough. Do not ask the human to poll.",
+    `Helper (same tool as \`scripts/detached-job.js\` when that file exists in the worktree): \`${invoke}\``,
+    `- Start once: \`${invoke} start <id> -- <command> [args...]\` (cwd = this worktree). If JSON says already-running, do not start again.`,
+    "- Immediately `present_artifact` `type=log` with `artifact_id=<id>` and `status=running` \u2014 the side column is the live view.",
+    `- Loop \`${invoke} wait <id>\` (returns in ~45s). stillRunning \u2192 present the same id with \`content=delta\` only \u2192 wait again. Do not resend the full log or HTML.`,
+    "- ok \u2192 finish the task. failed \u2192 read the log, fix, start once.",
+    "State: `.sideboard/detached-jobs/<id>/` (local scratch). Full guide: `/long-running` (always available)."
+  ].join("\n");
+}
+function formatLongRunningReminder(opts) {
+  const invoke = formatDetachedJobInvoke(opts?.scriptPath);
+  return `Long jobs: \`${invoke} start <id> -- <cmd>\`, loop wait, present_artifact type=log (delta). Do not ask the human to poll.`;
+}
 function formatArtifactDirective() {
   return [
     "Sideboard side column (desktop UI):",
@@ -5115,8 +5344,8 @@ function loadAgentInstructions(worktreePath, agent) {
   const out = [];
   for (const rel of candidates) {
     if (seenPaths.has(rel)) continue;
-    const abs = join12(worktreePath, rel);
-    if (!existsSync13(abs)) continue;
+    const abs = join13(worktreePath, rel);
+    if (!existsSync14(abs)) continue;
     try {
       if (!statSync4(abs).isFile()) continue;
       let content = readFileSync10(abs, "utf8");
@@ -5160,6 +5389,253 @@ function withAgentInstructions(prompt, files) {
 ${prompt}`;
 }
 
+// src/integrations/optional-services.ts
+var OPTIONAL_SERVICE_IDS = ["vercel", "supabase", "posthog", "sentry"];
+var OPTIONAL_SERVICES = [
+  {
+    id: "vercel",
+    label: "Vercel",
+    hint: "Deploys and project settings. Agents use the `vercel` CLI (`VERCEL_TOKEN`).",
+    tokenPlaceholder: "token from vercel.com/account/tokens",
+    tokenDocs: "https://vercel.com/account/tokens",
+    envKey: "VERCEL_TOKEN",
+    cli: "vercel",
+    npmPackage: "vercel"
+  },
+  {
+    id: "supabase",
+    label: "Supabase",
+    hint: "Database and project management. Agents use the `supabase` CLI (`SUPABASE_ACCESS_TOKEN`).",
+    tokenPlaceholder: "sbp_\u2026",
+    tokenDocs: "https://supabase.com/dashboard/account/tokens",
+    envKey: "SUPABASE_ACCESS_TOKEN",
+    cli: "supabase",
+    npmPackage: "supabase"
+  },
+  {
+    id: "posthog",
+    label: "PostHog",
+    hint: "Product analytics. No first-class CLI \u2014 agents use the HTTP API (`POSTHOG_PERSONAL_API_KEY`).",
+    tokenPlaceholder: "phx_\u2026",
+    tokenDocs: "https://app.posthog.com/settings/user-api-keys",
+    envKey: "POSTHOG_PERSONAL_API_KEY",
+    hostEnvKey: "POSTHOG_HOST",
+    defaultHost: "https://us.posthog.com",
+    hostPlaceholder: "https://us.posthog.com"
+  },
+  {
+    id: "sentry",
+    label: "Sentry",
+    hint: "Error tracking. Agents use `sentry-cli` (`SENTRY_AUTH_TOKEN`).",
+    tokenPlaceholder: "sntrys_\u2026 or auth token",
+    tokenDocs: "https://sentry.io/settings/account/api/auth-tokens/",
+    envKey: "SENTRY_AUTH_TOKEN",
+    cli: "sentry-cli",
+    npmPackage: "@sentry/cli",
+    hostEnvKey: "SENTRY_URL",
+    defaultHost: "https://sentry.io",
+    hostPlaceholder: "https://sentry.io"
+  }
+];
+function optionalServiceSpec(id) {
+  const spec = OPTIONAL_SERVICES.find((s) => s.id === id);
+  if (!spec) throw new Error(`Unknown optional service: ${id}`);
+  return spec;
+}
+function isOptionalServiceId(value) {
+  return typeof value === "string" && OPTIONAL_SERVICE_IDS.includes(value);
+}
+function normalizeServiceOrigin(raw, fallback) {
+  const trimmed = raw?.trim() || fallback;
+  try {
+    const url = new URL(trimmed.includes("://") ? trimmed : `https://${trimmed}`);
+    if (url.protocol !== "http:" && url.protocol !== "https:") return fallback;
+    return `${url.protocol}//${url.host}`;
+  } catch {
+    return fallback;
+  }
+}
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function asString(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function firstString(record, keys) {
+  if (!record) return "";
+  for (const key of keys) {
+    const value = asString(record[key]);
+    if (value) return value;
+  }
+  return "";
+}
+async function readJson(res) {
+  const text = await res.text();
+  if (!text.trim()) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+async function authorizedGet(url, token) {
+  const res = await httpFetch(url, {
+    method: "GET",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/json"
+    }
+  });
+  const body = await readJson(res);
+  if (!res.ok) {
+    const record = asRecord(body);
+    const message = firstString(record, ["message", "error", "error_description", "detail"]) || (typeof body === "string" ? body.trim().slice(0, 160) : "");
+    throw new Error(
+      message ? `${res.status}: ${message}` : `Request failed (${res.status})`
+    );
+  }
+  return body;
+}
+async function verifyOptionalService(input) {
+  const token = input.token.trim();
+  if (!token) throw new Error("A token is required");
+  const spec = optionalServiceSpec(input.id);
+  try {
+    if (input.id === "vercel") {
+      const body2 = asRecord(await authorizedGet("https://api.vercel.com/v2/user", token));
+      const user = asRecord(body2?.user) ?? body2;
+      const name2 = firstString(user, ["username", "name", "email"]) || "Vercel user";
+      return { viewerName: name2 };
+    }
+    if (input.id === "supabase") {
+      const body2 = await authorizedGet("https://api.supabase.com/v1/organizations", token);
+      const list2 = Array.isArray(body2) ? body2 : [];
+      const first2 = asRecord(list2[0]);
+      const name2 = firstString(first2, ["name", "slug"]) || "Supabase";
+      return { viewerName: list2.length > 1 ? `${name2} +${list2.length - 1}` : name2 };
+    }
+    if (input.id === "posthog") {
+      const host2 = normalizeServiceOrigin(input.host, spec.defaultHost ?? "https://us.posthog.com");
+      const body2 = asRecord(await authorizedGet(`${host2}/api/users/@me/`, token));
+      const name2 = firstString(body2, ["email", "distinct_id"]) || [firstString(body2, ["first_name"]), firstString(body2, ["last_name"])].filter(Boolean).join(" ") || "PostHog user";
+      return { viewerName: name2, host: host2 };
+    }
+    const host = normalizeServiceOrigin(input.host, spec.defaultHost ?? "https://sentry.io");
+    const body = await authorizedGet(`${host}/api/0/organizations/`, token);
+    const list = Array.isArray(body) ? body : [];
+    const first = asRecord(list[0]);
+    const name = firstString(first, ["slug", "name"]) || "Sentry";
+    return { viewerName: list.length > 1 ? `${name} +${list.length - 1}` : name, host };
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `${spec.label} rejected this token. ${detail} Create a token at ${spec.tokenDocs}`
+    );
+  }
+}
+function applyConnection(integrations, id, input) {
+  if (id === "vercel") {
+    integrations.vercelToken = input.token;
+    if (input.viewerName) integrations.vercelViewerName = input.viewerName.slice(0, 120);
+    return;
+  }
+  if (id === "supabase") {
+    integrations.supabaseAccessToken = input.token;
+    if (input.viewerName) integrations.supabaseViewerName = input.viewerName.slice(0, 120);
+    return;
+  }
+  if (id === "posthog") {
+    integrations.posthogPersonalApiKey = input.token;
+    if (input.host) integrations.posthogHost = input.host;
+    if (input.viewerName) integrations.posthogViewerName = input.viewerName.slice(0, 120);
+    return;
+  }
+  integrations.sentryAuthToken = input.token;
+  if (input.host) integrations.sentryHost = input.host;
+  if (input.viewerName) integrations.sentryViewerName = input.viewerName.slice(0, 120);
+}
+function clearConnection(integrations, id) {
+  if (id === "vercel") {
+    delete integrations.vercelToken;
+    delete integrations.vercelViewerName;
+    return;
+  }
+  if (id === "supabase") {
+    delete integrations.supabaseAccessToken;
+    delete integrations.supabaseViewerName;
+    return;
+  }
+  if (id === "posthog") {
+    delete integrations.posthogPersonalApiKey;
+    delete integrations.posthogViewerName;
+    delete integrations.posthogHost;
+    return;
+  }
+  delete integrations.sentryAuthToken;
+  delete integrations.sentryViewerName;
+  delete integrations.sentryHost;
+}
+async function connectOptionalService(input) {
+  if (!isOptionalServiceId(input.id)) {
+    throw new Error("Unknown optional service");
+  }
+  const verified = await verifyOptionalService(input);
+  const current = loadAppSettings();
+  const integrations = { ...current.integrations };
+  applyConnection(integrations, input.id, {
+    token: input.token.trim(),
+    host: verified.host,
+    viewerName: verified.viewerName
+  });
+  return saveAppSettings({ ...current, integrations });
+}
+function disconnectOptionalService(id) {
+  if (!isOptionalServiceId(id)) {
+    throw new Error("Unknown optional service");
+  }
+  const current = loadAppSettings();
+  const integrations = { ...current.integrations };
+  clearConnection(integrations, id);
+  return saveAppSettings({ ...current, integrations });
+}
+function optionalServiceConnected(id, integrations) {
+  if (id === "vercel") return Boolean(integrations.vercelToken?.trim());
+  if (id === "supabase") return Boolean(integrations.supabaseAccessToken?.trim());
+  if (id === "posthog") return Boolean(integrations.posthogPersonalApiKey?.trim());
+  return Boolean(integrations.sentryAuthToken?.trim());
+}
+function connectedOptionalServices(integrations) {
+  return OPTIONAL_SERVICES.filter((spec) => optionalServiceConnected(spec.id, integrations));
+}
+function formatOptionalServicesDirective(integrations) {
+  const connected = connectedOptionalServices(integrations);
+  if (connected.length === 0) return null;
+  const lines = [
+    "Optional connectors (connected \u2014 tokens are already in this process env):"
+  ];
+  for (const spec of connected) {
+    if (spec.cli) {
+      const extras = spec.hostEnvKey ? ` / \`${spec.hostEnvKey}\`` : "";
+      lines.push(
+        `- ${spec.label}: use the \`${spec.cli}\` CLI (\`${spec.envKey}\`${extras}). Do not add a ${spec.label} MCP.`
+      );
+    } else {
+      const extras = spec.hostEnvKey ? ` / \`${spec.hostEnvKey}\`` : "";
+      lines.push(
+        `- ${spec.label}: no first-class CLI \u2014 call the HTTP API with \`${spec.envKey}\`${extras}. Do not add a ${spec.label} MCP.`
+      );
+    }
+  }
+  lines.push(
+    "If a CLI is missing, say so or use the HTTP API with the same token. The user can Install CLI from Settings \u2192 Connectors. Do not ask the user to install a vendor MCP."
+  );
+  return lines.join("\n");
+}
+function formatOptionalServicesReminder(integrations) {
+  if (connectedOptionalServices(integrations).length === 0) return null;
+  return "Settings \u2192 Connectors: prefer official CLIs (`vercel`, `supabase`, `sentry-cli`) or the PostHog HTTP API with injected env. Do not add vendor MCPs.";
+}
+
 // src/threads/sync-branch.ts
 async function syncThreadBranchFromGit(threadId) {
   const thread = readThread(threadId);
@@ -5192,8 +5668,8 @@ async function syncThreadBranchFromGit(threadId) {
 
 // src/store/schedules.ts
 import { randomUUID as randomUUID4 } from "crypto";
-import { existsSync as existsSync14, readFileSync as readFileSync11 } from "fs";
-import { join as join13 } from "path";
+import { existsSync as existsSync15, readFileSync as readFileSync11 } from "fs";
+import { join as join14 } from "path";
 import { Cron } from "croner";
 var DURATION_RE = /^(\d+)(s|m|h|d)$/i;
 var UNIT_MS = {
@@ -5203,7 +5679,7 @@ var UNIT_MS = {
   d: 864e5
 };
 function schedulesPath() {
-  return join13(appDataDir(), "schedules.json");
+  return join14(appDataDir(), "schedules.json");
 }
 function parseDurationMs(every) {
   const m = every.trim().match(DURATION_RE);
@@ -5309,7 +5785,7 @@ function normalizeTask(raw) {
 }
 function readAll() {
   const path = schedulesPath();
-  if (!existsSync14(path)) return [];
+  if (!existsSync15(path)) return [];
   try {
     const parsed = JSON.parse(readFileSync11(path, "utf8"));
     if (!Array.isArray(parsed)) return [];
@@ -5437,7 +5913,7 @@ function formatScheduledPrompt(name, prompt) {
 ${prompt}`;
 }
 async function defaultDeps() {
-  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-WEFXUHFX.js");
+  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-VIFXOHF4.js");
   const orch = getOrchestrator2();
   return {
     findThread: (id) => findThreadByRef(id),
@@ -5643,7 +6119,7 @@ var Orchestrator = class {
         }
         continue;
       }
-      if (!existsSync15(thread.worktreePath)) {
+      if (!existsSync16(thread.worktreePath)) {
         setStatus(thread.id, "broken", "Worktree missing on disk");
         this.emit({ type: "status_changed", threadId: thread.id, status: "broken" });
         continue;
@@ -5662,7 +6138,7 @@ var Orchestrator = class {
           orphans: orphans.map((o) => ({ path: o.path, repoPath: o.repoPath }))
         });
       }
-      const { autoCleanupOrphansEnabled } = await import("./app-settings-U5RZKUXG.js");
+      const { autoCleanupOrphansEnabled } = await import("./app-settings-WJDCJFSY.js");
       if (autoCleanupOrphansEnabled() && shouldRunWorktreeCleanup() && orphans.length > 0) {
         await cleanupOrphanWorktrees({ repoPaths });
       }
@@ -5902,7 +6378,7 @@ var Orchestrator = class {
     }
     await setup;
     if (skipSetup) return;
-    const { autoRunAfterSetupEnabled } = await import("./app-settings-U5RZKUXG.js");
+    const { autoRunAfterSetupEnabled } = await import("./app-settings-WJDCJFSY.js");
     if (autoRunAfterSetupEnabled()) {
       try {
         await this.startDev(threadId);
@@ -6164,7 +6640,9 @@ var Orchestrator = class {
       ].join("\n") : null
     ].filter(Boolean).join("\n") : null;
     const artifactReminder = thread.agent !== "brightsy" ? formatUiReminder() : null;
+    const longRunningReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) ? formatLongRunningReminder() : null;
     const worktreeReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) ? formatWorktreeReminder() : null;
+    const optionalServicesReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) ? formatOptionalServicesReminder(loadAppSettings().integrations) : null;
     const slackReplyContext = formatSlackRepliesForTurn(
       pendingSlackExternalReplies(thread.messages)
     );
@@ -6172,7 +6650,9 @@ var Orchestrator = class {
       thread.planMode ? PLAN_MODE_INSTRUCTION : null,
       orchestrationReminder,
       worktreeReminder,
+      optionalServicesReminder,
       artifactReminder,
+      longRunningReminder,
       slackReplyContext,
       expandedPrompt
     ].filter(Boolean).join("\n\n");
@@ -6192,7 +6672,7 @@ var Orchestrator = class {
     }
     const isBrightsy = fresh.agent === "brightsy";
     const isOrchestration = isOrchestratorThread(fresh);
-    const { autoRenameBranchEnabled, getGithubGitAuthMode } = await import("./app-settings-U5RZKUXG.js");
+    const { autoRenameBranchEnabled, getGithubGitAuthMode } = await import("./app-settings-WJDCJFSY.js");
     const gitAuthMode = getGithubGitAuthMode();
     const worktreeDirective = isBrightsy || isOrchestration ? null : formatWorktreeDirective(fresh, {
       githubSlug: await resolveGithubRepoSlug(fresh.worktreePath).catch(
@@ -6201,6 +6681,8 @@ var Orchestrator = class {
       gitAuthMode
     });
     const artifactDirective = isBrightsy ? null : formatArtifactDirective();
+    const longRunningDirective = isBrightsy || isOrchestration ? null : formatLongRunningDirective();
+    const optionalServicesDirective = isBrightsy || isOrchestration ? null : formatOptionalServicesDirective(loadAppSettings().integrations);
     const settings = loadWorkspaceSettings(fresh.worktreePath, fresh.repoPath);
     const renameBranchDirective = !isBrightsy && !isOrchestration && autoRenameBranchEnabled() ? formatRenameBranchDirective(fresh, {
       customPrompt: settings?.prompts?.renameBranch
@@ -6208,7 +6690,7 @@ var Orchestrator = class {
     let seed = null;
     if (!fresh.sessionId) {
       const prior = fresh.messages.slice(0, -1);
-      seed = isBrightsy ? buildSessionSeed(prior.slice(-6), { tools: "none" }) : buildSessionSeed(prior);
+      seed = isBrightsy ? buildBrightsySessionSeed(prior) : buildSessionSeed(prior);
     }
     let coordinatorDirective = null;
     if (isOrchestration) {
@@ -6230,7 +6712,9 @@ var Orchestrator = class {
     const cachedPrefix = fresh.sessionId ? "" : [
       coordinatorDirective,
       worktreeDirective,
+      optionalServicesDirective,
       artifactDirective,
+      longRunningDirective,
       renameBranchDirective,
       seed
     ].filter(Boolean).join("\n\n---\n\n");
@@ -6333,11 +6817,13 @@ var Orchestrator = class {
         });
         const retryThread = this.requireThread(threadId);
         const prior = retryThread.messages.slice(0, -1);
-        const retrySeed = buildSessionSeed(prior);
+        const retrySeed = isBrightsy ? buildBrightsySessionSeed(prior) : buildSessionSeed(prior);
         const retryPrefix = [
           coordinatorDirective,
           worktreeDirective,
+          optionalServicesDirective,
           artifactDirective,
+          longRunningDirective,
           renameBranchDirective,
           retrySeed
         ].filter(Boolean).join("\n\n---\n\n");
@@ -7014,7 +7500,7 @@ var Orchestrator = class {
         updateThread(thread.id, { title: meta.title });
       }
     }
-    const { autoArchiveOnMergeEnabled } = await import("./app-settings-U5RZKUXG.js");
+    const { autoArchiveOnMergeEnabled } = await import("./app-settings-WJDCJFSY.js");
     const latest = this.requireThread(thread.id);
     if (!shouldAutoArchiveOnPrMerge({
       previousPrState: prevState || null,
@@ -7324,7 +7810,7 @@ var Orchestrator = class {
     this.emit({ type: "status_changed", threadId: archived.id, status: "archived" });
     if (thread.repoPath && !isGlobalRepoPath(thread.repoPath)) {
       try {
-        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-ALCTB65T.js");
+        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-PU5YHQ7Z.js");
         await ensureWorkspace2(thread.repoPath);
       } catch {
       }
@@ -7351,7 +7837,7 @@ var Orchestrator = class {
           await runArchiveScript(thread.repoPath, thread.worktreePath);
         } catch {
         }
-        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-U5RZKUXG.js");
+        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-WJDCJFSY.js");
         const deleteBranch = opts?.deleteBranch ?? deleteBranchOnPurgeEnabled();
         await removeWorktree(thread.repoPath, thread.worktreePath, {
           deleteBranch: deleteBranch ? thread.branchName : void 0
@@ -7372,13 +7858,13 @@ var Orchestrator = class {
       this.emit({ type: "status_changed", threadId: restored2.id, status: restored2.status });
       return restored2;
     }
-    if (!existsSync15(thread.worktreePath)) {
+    if (!existsSync16(thread.worktreePath)) {
       if (isCowboyThread(thread) || isPrimaryCheckoutThread(thread)) {
         throw new Error(
           `Cowboy checkout missing: ${thread.worktreePath}. Re-add the project folder, then restore.`
         );
       }
-      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-GXD2NGOZ.js");
+      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-GKLPPNWR.js");
       const slug = thread.worktreePath.split("/").pop();
       const dest = thread.worktreePath;
       await withRepoGitLock(thread.repoPath, async () => {
@@ -7486,7 +7972,7 @@ async function startOrchestration(opts) {
     sourceRef: "default",
     ...createOpts
   }).catch(async () => {
-    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-GXD2NGOZ.js");
+    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-GKLPPNWR.js");
     const repo = await resolveRepoRoot2(repoPath);
     const def = await resolveDefaultBranch2(repo);
     return orch.createThread({
@@ -7557,6 +8043,7 @@ export {
   estimateThreadChars,
   estimateOccupancyTokens,
   threadHasCompactedContext,
+  forwardOccupancyTokens,
   forwardContextUsage,
   applyForwardOccupancy,
   summarizeConversation,
@@ -7570,6 +8057,11 @@ export {
   splitForCompaction,
   formatMessagesAsTranscript,
   buildSessionSeed,
+  BRIGHTSY_SUMMARIZE_CONTEXT_TOOL,
+  extractBrightsyContextSummary,
+  findLastBrightsyContextSummary,
+  messagesSinceLastBrightsyContextSummary,
+  buildBrightsySessionSeed,
   applyCompaction,
   lastRequestOccupancy,
   shouldResetSessionForOccupancy,
@@ -7675,18 +8167,38 @@ export {
   getDiffSummary,
   previewLand,
   confirmLand,
+  LONG_RUNNING_SKILL_COMMAND,
+  BUNDLED_LONG_RUNNING_PATH,
+  BUNDLED_SKILL_PREFIX,
   discoverSkills,
   readSkillBody,
   expandComposerPrompt,
+  packagedDetachedJobPath,
+  resolveDetachedJobScript,
+  formatDetachedJobInvoke,
   formatRenameBranchDirective,
   formatWorktreeDirective,
   formatWorktreeReminder,
   formatProcessGuideDirective,
+  formatLongRunningDirective,
+  formatLongRunningReminder,
   formatArtifactDirective,
   formatUiReminder,
   loadAgentInstructions,
   formatAgentInstructions,
   withAgentInstructions,
+  OPTIONAL_SERVICE_IDS,
+  OPTIONAL_SERVICES,
+  optionalServiceSpec,
+  isOptionalServiceId,
+  normalizeServiceOrigin,
+  verifyOptionalService,
+  connectOptionalService,
+  disconnectOptionalService,
+  optionalServiceConnected,
+  connectedOptionalServices,
+  formatOptionalServicesDirective,
+  formatOptionalServicesReminder,
   isPidAlive,
   waitForPidExit,
   Orchestrator,