@sideboard-ai/core 0.1.136 → 0.1.142

package/dist/{chunk-TIGKDMIA.js → chunk-FGOD5MQ4.js}

@@ -18,13 +18,13 @@ import {
   stripBrightsyNdjsonNoise,
   sumUsageList,
   toolDescription
-} from "./chunk-CYM5DCHI.js";
+} from "./chunk-VHTIHOHE.js";
 import {
   addWorkspace,
   ensureWorkspace,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-MDCKV2NF.js";
+} from "./chunk-HC5N3BDL.js";
 import {
   assertOrchestratorCapableAgent,
   attachmentsFromWorktreePaths,
@@ -41,14 +41,17 @@ import {
   persistPendingFileAttachments,
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments
-} from "./chunk-GSKRGF7B.js";
+} from "./chunk-R2W7A2UO.js";
 import {
   SLACK_REPLY_FORMATTING,
   coordinatorSystemPrompt,
   coordinatorTurnReminder,
   enrichWorkspacesWithGithub,
   ensureGlobalCoordinatorCwd
-} from "./chunk-IFZ4MOTN.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-HQQNLDVC.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";
@@ -155,7 +160,7 @@ import {
   updateThread,
   withThreadLock,
   writeThread
-} from "./chunk-PM3C2J6K.js";
+} from "./chunk-TUGKX5BD.js";
 import {
   appDataDir,
   findConventionSetup,
@@ -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-6I47JMU2.js");
+    const { getOrchestrator: getOrchestrator2 } = await import("./orchestrator-I2T44CRP.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-NIKZAKOO.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-NG7SU3GV.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-IPL4Z6SL.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-2LD3C74O.js");
     ensureGlobalCoordinatorCwd2(
       isOrchestratorThread(thread) ? { orchestratorThreadId: thread.id } : void 0
     );
@@ -977,6 +982,69 @@ import { dirname, join as join4 } from "path";
 // src/threads/chat-tabs.ts
 import { randomUUID } from "crypto";
 
+// src/composer/context-estimate.ts
+var CHARS_PER_CONTEXT_TOKEN = 4;
+function estimateMessageChars(message) {
+  let n = message.text.length + 16;
+  for (const part of message.parts ?? []) {
+    n += estimatePartChars(part);
+  }
+  return n;
+}
+function estimatePartChars(part) {
+  switch (part.type) {
+    case "text":
+    case "thinking":
+      return part.text.length;
+    case "tool": {
+      const input = part.input ? JSON.stringify(part.input) : "";
+      return part.name.length + (part.description?.length ?? 0) + (part.detail?.length ?? 0) + (part.result?.length ?? 0) + input.length + 32;
+    }
+    default:
+      return 0;
+  }
+}
+function estimateThreadChars(messages) {
+  return messages.reduce((sum, m) => sum + estimateMessageChars(m), 0);
+}
+function estimateOccupancyTokens(messages) {
+  return Math.ceil(estimateThreadChars(messages) / CHARS_PER_CONTEXT_TOKEN);
+}
+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;
+  const remaining = estimateOccupancyTokens(messages);
+  const current = contextTokens(usage);
+  if (remaining <= 0 || remaining >= current) return usage;
+  return { ...usage, lastRequestTokens: remaining };
+}
+function applyForwardOccupancy(messages) {
+  const tokens = estimateOccupancyTokens(messages);
+  if (tokens <= 0) return messages;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.role !== "agent" || !m.usage) continue;
+    const current = contextTokens(m.usage);
+    if (tokens >= current) return messages;
+    const next = messages.slice();
+    next[i] = { ...m, usage: { ...m.usage, lastRequestTokens: tokens } };
+    return next;
+  }
+  return messages;
+}
+
 // src/composer/summarize.ts
 var MAX_TRANSCRIPT_CHARS = 12e4;
 var MAX_SUMMARY_CHARS = 6e3;
@@ -1085,29 +1153,6 @@ var CONTEXT_KEEP_RECENT_CHARS = 24e3;
 var CONTEXT_KEEP_RECENT_MESSAGES = 12;
 var CONTEXT_MIN_MESSAGES = 10;
 var SESSION_RESET_OCCUPANCY_TOKENS = 75e4;
-function estimateMessageChars(message) {
-  let n = message.text.length + 16;
-  for (const part of message.parts ?? []) {
-    n += estimatePartChars(part);
-  }
-  return n;
-}
-function estimatePartChars(part) {
-  switch (part.type) {
-    case "text":
-    case "thinking":
-      return part.text.length;
-    case "tool": {
-      const input = part.input ? JSON.stringify(part.input) : "";
-      return part.name.length + (part.description?.length ?? 0) + (part.detail?.length ?? 0) + (part.result?.length ?? 0) + input.length + 32;
-    }
-    default:
-      return 0;
-  }
-}
-function estimateThreadChars(messages) {
-  return messages.reduce((sum, m) => sum + estimateMessageChars(m), 0);
-}
 function shouldCompactContext(messages, thresholds = {}) {
   const maxChars = thresholds.maxChars ?? CONTEXT_COMPACT_CHARS;
   const minMessages = thresholds.minMessages ?? CONTEXT_MIN_MESSAGES;
@@ -1244,8 +1289,11 @@ async function maybeCompactContext(thread, thresholds = {}, summarize = summariz
   const { summary, method } = await summarize(transcript, {
     cwd: thread.worktreePath
   });
-  const messages = applyCompaction(thread.messages, summary, thresholds);
+  let messages = applyCompaction(thread.messages, summary, thresholds);
   const resetSession = shouldResetSessionForOccupancy({ messages: thread.messages });
+  if (resetSession) {
+    messages = applyForwardOccupancy(messages);
+  }
   const next = {
     ...thread,
     messages,
@@ -2826,7 +2874,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."
@@ -2882,7 +2930,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
@@ -2955,7 +3003,7 @@ async function createThread(input, _onSetupLine) {
   return readThread(thread.id) ?? thread;
 }
 async function listLinearIssues(agent, repoPath) {
-  const { getAdapter: getAdapter2 } = await import("./agents-QNTTLMG2.js");
+  const { getAdapter: getAdapter2 } = await import("./agents-E5AAMHDY.js");
   await requireAgent(agent, { requireLinear: true });
   const adapter = getAdapter2(agent);
   if (!adapter.listLinearIssues) {
@@ -3352,7 +3400,7 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-KZA3TCEE.js");
+  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-PU5YHQ7Z.js");
   await ensureWorkspace2(repoPath);
   return thread;
 }
@@ -4695,6 +4743,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, "");
 }
@@ -4812,7 +4947,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);
@@ -4823,6 +4964,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);
@@ -4916,8 +5065,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(/\/+$/, "");
 }
@@ -5025,6 +5205,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).",
@@ -5032,6 +5213,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):",
@@ -5081,8 +5279,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");
@@ -5126,6 +5324,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);
@@ -5158,8 +5603,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 = {
@@ -5169,7 +5614,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);
@@ -5275,7 +5720,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 [];
@@ -5403,7 +5848,7 @@ function formatScheduledPrompt(name, prompt) {
 ${prompt}`;
 }
 async function defaultDeps() {
-  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-6I47JMU2.js");
+  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-I2T44CRP.js");
   const orch = getOrchestrator2();
   return {
     findThread: (id) => findThreadByRef(id),
@@ -5609,7 +6054,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;
@@ -5628,7 +6073,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 });
       }
@@ -5679,7 +6124,7 @@ var Orchestrator = class {
       if (thread.status === "archived") continue;
       const handle = this.activeTurns.get(thread.id);
       if (handle) {
-        const pid = thread.agentPid;
+        const pid = handle.pid;
         if (typeof pid === "number" && pid > 0 && !isPidAlive(pid)) {
           handle.kill();
         }
@@ -5868,7 +6313,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);
@@ -6130,7 +6575,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)
     );
@@ -6138,7 +6585,9 @@ var Orchestrator = class {
       thread.planMode ? PLAN_MODE_INSTRUCTION : null,
       orchestrationReminder,
       worktreeReminder,
+      optionalServicesReminder,
       artifactReminder,
+      longRunningReminder,
       slackReplyContext,
       expandedPrompt
     ].filter(Boolean).join("\n\n");
@@ -6158,7 +6607,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(
@@ -6167,6 +6616,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
@@ -6196,7 +6647,9 @@ var Orchestrator = class {
     const cachedPrefix = fresh.sessionId ? "" : [
       coordinatorDirective,
       worktreeDirective,
+      optionalServicesDirective,
       artifactDirective,
+      longRunningDirective,
       renameBranchDirective,
       seed
     ].filter(Boolean).join("\n\n---\n\n");
@@ -6303,7 +6756,9 @@ var Orchestrator = class {
         const retryPrefix = [
           coordinatorDirective,
           worktreeDirective,
+          optionalServicesDirective,
           artifactDirective,
+          longRunningDirective,
           renameBranchDirective,
           retrySeed
         ].filter(Boolean).join("\n\n---\n\n");
@@ -6503,7 +6958,7 @@ var Orchestrator = class {
     const stopped = writeLiveStatus(thread.id, "stopped") ?? readThread(thread.id) ?? thread;
     if (stopped.status === "stopped") {
       this.emit({ type: "status_changed", threadId: thread.id, status: "stopped" });
-      if (opts?.notifyParent !== false) {
+      if (inFlight && opts?.notifyParent !== false) {
         notifyParentOfChildHalt(stopped, "stopped", (id, prompt) => this.send(id, prompt));
       }
     }
@@ -6980,7 +7435,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,
@@ -7262,7 +7717,7 @@ var Orchestrator = class {
   }
   async archiveUnlocked(threadRef) {
     const thread = this.requireThread(threadRef);
-    this.stop(thread.id);
+    this.stop(thread.id, { notifyParent: false });
     this.releaseOrchestratorCaffeinate(thread);
     if (isGlobalThread(thread)) {
       const archived2 = setStatus(thread.id, "archived");
@@ -7290,7 +7745,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-KZA3TCEE.js");
+        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-PU5YHQ7Z.js");
         await ensureWorkspace2(thread.repoPath);
       } catch {
       }
@@ -7303,7 +7758,7 @@ var Orchestrator = class {
   }
   async purgeUnlocked(threadRef, opts) {
     const thread = this.requireThread(threadRef);
-    this.stop(thread.id);
+    this.stop(thread.id, { notifyParent: false });
     this.releaseOrchestratorCaffeinate(thread);
     if (isGlobalThread(thread)) {
       deleteThreadRecord(thread.id);
@@ -7317,7 +7772,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
@@ -7338,13 +7793,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-MX7XBX6Z.js");
+      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-GKLPPNWR.js");
       const slug = thread.worktreePath.split("/").pop();
       const dest = thread.worktreePath;
       await withRepoGitLock(thread.repoPath, async () => {
@@ -7452,7 +7907,7 @@ async function startOrchestration(opts) {
     sourceRef: "default",
     ...createOpts
   }).catch(async () => {
-    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-MX7XBX6Z.js");
+    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-GKLPPNWR.js");
     const repo = await resolveRepoRoot2(repoPath);
     const def = await resolveDefaultBranch2(repo);
     return orch.createThread({
@@ -7462,7 +7917,7 @@ async function startOrchestration(opts) {
       repoPath: repo
     });
   });
-  const { updateThread: upd } = await import("./thread-store-CRLQJ2HM.js");
+  const { updateThread: upd } = await import("./thread-store-WGASXXXR.js");
   const updated = upd(thread.id, {
     sourceType: "orchestration",
     sourceRef: goal
@@ -7518,6 +7973,14 @@ export {
   spawnAgentTurn,
   AGENT_GIT_ACTIONS,
   agentGitPrompt,
+  CHARS_PER_CONTEXT_TOKEN,
+  estimateMessageChars,
+  estimateThreadChars,
+  estimateOccupancyTokens,
+  threadHasCompactedContext,
+  forwardOccupancyTokens,
+  forwardContextUsage,
+  applyForwardOccupancy,
   summarizeConversation,
   extractiveSummary,
   CONTEXT_COMPACT_CHARS,
@@ -7525,8 +7988,6 @@ export {
   CONTEXT_KEEP_RECENT_MESSAGES,
   CONTEXT_MIN_MESSAGES,
   SESSION_RESET_OCCUPANCY_TOKENS,
-  estimateMessageChars,
-  estimateThreadChars,
   shouldCompactContext,
   splitForCompaction,
   formatMessagesAsTranscript,
@@ -7636,18 +8097,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,