@sideboard-ai/core 0.1.61 → 0.1.66

package/dist/index.d.cts

@@ -113,6 +113,18 @@ interface Thread {
     prUrl: string | null;
     /** Cached PR title for Conductor-style sidebar labels (PR title > branch). */
     prTitle: string | null;
+    /**
+     * Cached GitHub PR lifecycle from the last `getPrMeta` / merge
+     * (`OPEN` | `MERGED` | `CLOSED`, etc.). Used for purple “done” sidebar
+     * styling and Conductor-style auto-archive-on-merge.
+     */
+    prState: string | null;
+    /**
+     * When true, skip auto-archive if the PR is already MERGED (set on restore
+     * so unarchiving a merged workspace does not immediately re-archive).
+     * Cleared when `prState` becomes a non-merged open state again.
+     */
+    skipAutoArchiveOnMerge?: boolean;
     /**
      * Stable id for a GitHub PR stack this thread belongs to (shared across layer worktrees).
      * Null when not part of a stack.
@@ -581,14 +593,27 @@ interface ClaudeHarnessSettings {
     /** When true, pass `--chrome` on Claude turns. */
     chromeEnabled?: boolean;
 }
+/** Optional absolute path override for a CLI agent binary. */
+interface CliExecutableSettings {
+    /** Absolute path to the CLI. Empty/omitted = default name on PATH. */
+    executablePath?: string;
+}
 /** Local agent that runs the Brightsy cloud coordinator. */
 type BrightsyCloudConnectAgent = 'claude' | 'codex' | 'opencode' | 'cursor';
 /** Brightsy cloud remote-orchestrator preferences (Slack / Discord / Teams). */
 interface BrightsyHarnessSettings {
+    /** Absolute path to the Brightsy CLI. Empty/omitted = `brightsy` on PATH. */
+    executablePath?: string;
     /** When true, desktop app polls Brightsy for Sideboard cloud tasks. */
     cloudConnectEnabled?: boolean;
     /** Local agent used for the cloud coordinator (not Brightsy itself). */
     cloudConnectAgent?: BrightsyCloudConnectAgent;
+    /**
+     * When true, inject Brightsy MCP on every worktree agent turn (Claude / Codex /
+     * Cursor / OpenCode) if logged in. Default off: only when the user asks
+     * (“use Brightsy…”) or the thread already used it. Orchestration always injects.
+     */
+    injectWorktreeMcp?: boolean;
 }
 /** Preferred issue tracker for Create-from / Link issue. */
 type IssueSource = 'linear' | 'github';
@@ -636,6 +661,11 @@ interface AdvancedAppSettings {
      * Conductor: `git.delete_branch_on_archive` (default off).
      */
     deleteBranchOnPurge?: boolean;
+    /**
+     * When a linked PR becomes MERGED, archive the worktree’s chats.
+     * Conductor: auto-archive on merge (opt-in; default off).
+     */
+    autoArchiveOnMerge?: boolean;
     /** Max concurrent agent turns across the orchestrator (default 3). */
     maxConcurrent?: number;
     /**
@@ -663,6 +693,10 @@ interface AppSettings {
     environment: Record<string, string>;
     /** Claude Code–specific harness settings. */
     claude: ClaudeHarnessSettings;
+    /** Codex CLI executable override. */
+    codex: CliExecutableSettings;
+    /** OpenCode CLI executable override. */
+    opencode: CliExecutableSettings;
     /** Brightsy cloud connect preferences (Slack / Discord / Teams). */
     brightsy: BrightsyHarnessSettings;
     /** GitHub / Linear connections and issue-source preference. */
@@ -683,8 +717,16 @@ declare function updateClaudeSettings(patch: {
     chromeEnabled?: boolean;
 }): AppSettings;
 declare function updateBrightsySettings(patch: {
+    executablePath?: string | null;
     cloudConnectEnabled?: boolean;
     cloudConnectAgent?: BrightsyCloudConnectAgent | null;
+    injectWorktreeMcp?: boolean;
+}): AppSettings;
+declare function updateCodexSettings(patch: {
+    executablePath?: string | null;
+}): AppSettings;
+declare function updateOpencodeSettings(patch: {
+    executablePath?: string | null;
 }): AppSettings;
 declare function updateIntegrationsSettings(patch: {
     linearApiKey?: string | null;
@@ -739,6 +781,8 @@ declare function getIssueSource(settings?: AppSettings): IssueSource;
 declare function resolveEffectiveIssueSource(settings?: AppSettings): IssueSource;
 declare function getLinearApiKey(settings?: AppSettings): string | null;
 declare function brightsyCloudConnectEnabled(settings?: AppSettings): boolean;
+/** Default off — worktree agents only get Brightsy MCP on ask / prior use. */
+declare function brightsyInjectWorktreeMcpEnabled(settings?: AppSettings): boolean;
 /**
  * Local agent for the Brightsy cloud coordinator.
  * Prefer Account → Default agent when it can run orchestration (Claude / Cursor /
@@ -753,6 +797,8 @@ declare function autoRunAfterSetupEnabled(settings?: AppSettings): boolean;
 declare function caffeinateWhileRunningEnabled(settings?: AppSettings): boolean;
 declare function caffeinateWhileCloudConnectEnabled(settings?: AppSettings): boolean;
 declare function deleteBranchOnPurgeEnabled(settings?: AppSettings): boolean;
+/** Conductor-style opt-in — default off. */
+declare function autoArchiveOnMergeEnabled(settings?: AppSettings): boolean;
 declare function autoCleanupOrphansEnabled(settings?: AppSettings): boolean;
 /** Default: switch to another agent (Auto) when orchestration hits a session limit. */
 declare function orchestrationQuotaOnLimit(settings?: AppSettings): OrchestrationQuotaOnLimit;
@@ -761,6 +807,11 @@ declare function orchestrationQuotaFallbackAgent(settings?: AppSettings): AgentK
 declare function maxConcurrentAgents(settings?: AppSettings): number;
 /** Binary name or absolute path used to spawn Claude Code. */
 declare function resolveClaudeExecutable(settings?: AppSettings): string;
+/** CLI agents that support a custom executable path override. */
+type CliAgentKind = 'claude' | 'codex' | 'opencode' | 'brightsy';
+/** Binary name or absolute path for a CLI agent (custom path when set). */
+declare function resolveAgentExecutable(agent: CliAgentKind, settings?: AppSettings): string;
+declare function updateAgentExecutable(agent: CliAgentKind, executablePath: string | null): AppSettings;
 declare function claudeChromeEnabled(settings?: AppSettings): boolean;
 /**
  * Apply Sideboard-managed environment onto a process env object.
@@ -783,7 +834,7 @@ declare function resolveThreadEffort(raw: {
     fast?: unknown;
 }): ThinkingEffort;
 declare function normalizeThread(raw: Thread): Thread;
-declare function createEmptyThread(partial: Omit<Thread, 'id' | 'createdAt' | 'updatedAt' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'attachments'> & Partial<Pick<Thread, 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'attachments'>>): Thread;
+declare function createEmptyThread(partial: Omit<Thread, 'id' | 'createdAt' | 'updatedAt' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'prState' | 'skipAutoArchiveOnMerge' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'attachments'> & Partial<Pick<Thread, 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'prState' | 'skipAutoArchiveOnMerge' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'attachments'>>): Thread;
 declare function withThreadLock<T>(id: string, fn: () => Promise<T>): Promise<T>;
 declare function readThread(id: string): Thread | null;
 declare function writeThread(thread: Thread): void;
@@ -1209,6 +1260,11 @@ interface AgentTurnInput {
     prompt: string;
 }
 declare function normalizeTurnInput(input: string | AgentTurnInput): Required<Pick<AgentTurnInput, 'prompt'>> & AgentTurnInput;
+/**
+ * Resumed CLI sessions already hold history + first-turn prefix. Re-sending
+ * cachedPrefix (worktree playbook, AGENTS.md, artifact docs) doubles tokens.
+ */
+declare function dropCachedPrefixOnResume(input: string | AgentTurnInput, sessionId: string | null | undefined): AgentTurnInput;
 /**
  * Flatten to a single string for CLIs that don't accept cache_control blocks
  * (Codex today; OpenCode `run` is plain text — OpenCode applies provider caching
@@ -1475,6 +1531,21 @@ declare function coerceOrchestratorAgent(agent: AgentKind | null | undefined, fa
  * once at process start (and before agent spawns) so adapters can resolve CLIs.
  */
 declare function ensureAgentPath(env?: NodeJS.ProcessEnv): string;
+/**
+ * Prepend the active `npm prefix -g`/bin dir (where `npm i -g @openai/codex`
+ * lands). Electron often finds this via ensureAgentPath heuristics, but a
+ * fresh Terminal window may not — causing "codex: command not found" on login.
+ */
+declare function enrichPathWithNpmGlobalBin(env?: NodeJS.ProcessEnv): string;
+/** Escape a value for use inside a POSIX single-quoted string. */
+declare function posixShellSingleQuote(value: string): string;
+/**
+ * Rewrite `codex login` → `/abs/path/codex login` when `which` can see the bin
+ * on the enriched Electron PATH.
+ */
+declare function resolveCommandBinarySync(command: string, whichPath: string | null | undefined): string;
+/** `export PATH='…'; <command>` so Terminal inherits Electron’s enriched PATH. */
+declare function withExportedPath(command: string, pathValue: string): string;
 
 type AgentSetupKind = 'cli' | 'api-key' | 'bundled-sdk';
 interface AgentSetupInfo {
@@ -1502,6 +1573,14 @@ interface AgentSetupActionResult {
 }
 declare function getAgentSetupInfo(agent: AgentKind): AgentSetupInfo;
 declare function listAgentSetupInfo(): AgentSetupInfo[];
+/** Rewrite login command to honor a custom executable path override. */
+declare function resolveLoginCommand(agent: AgentKind): string | null;
+/**
+ * Make a Terminal command resolve the same binaries Electron sees after
+ * `npm i -g` (absolute path + exported PATH). Avoids "codex: command not found"
+ * when Terminal’s login shell lacks the npm global bin.
+ */
+declare function prepareTerminalCommand(command: string): Promise<string>;
 /**
  * Open an interactive shell command in the system terminal (macOS Terminal.app,
  * Linux gnome-terminal/x-terminal-emulator, Windows cmd).
@@ -1594,6 +1673,8 @@ declare function formatWorktreeDirective(thread: Pick<Thread, 'worktreePath' | '
  * Tell agents how Sideboard renders Claude-style artifacts (side column).
  * Claude Code has no claude.ai `artifact` tool — fences / present_artifact instead.
  */
+/** Short isolation line on every worktree turn (survives CLI resume). */
+declare function formatWorktreeReminder(): string;
 declare function formatArtifactDirective(): string;
 interface AgentInstructionFile {
     relativePath: string;
@@ -2392,6 +2473,11 @@ declare class Orchestrator {
     private withPrSelector;
     getPrChecks(threadRef: string): Promise<PrCheckRun[] | null>;
     getPrMeta(threadRef: string): Promise<PrMeta | null>;
+    /**
+     * Persist PR URL/title/state and Conductor-style auto-archive when the PR
+     * first becomes MERGED.
+     */
+    private persistPrMetaAndMaybeArchive;
     getPrStack(threadRef: string): Promise<PrStack | null>;
     /** Open worktrees for all (or one) stack layers discovered from a thread. */
     openPrStackLayers(threadRef: string, opts?: {
@@ -2713,6 +2799,11 @@ declare function cloneRepoIntoSideboard(opts: {
  */
 declare function startMcpServer(): Promise<void>;
 
+/** Injected Sideboard MCP: worktree turns list UI tools only; orchestration gets the fleet. */
+type SideboardMcpProfile = 'worktree' | 'orchestration';
+declare const SIDEBOARD_MCP_PROFILE_ENV = "SIDEBOARD_MCP_PROFILE";
+declare function sideboardMcpProfile(env?: NodeJS.ProcessEnv): SideboardMcpProfile;
+
 interface BrightsyLocalConfig {
     access_token: string;
     refresh_token?: string;
@@ -2784,10 +2875,16 @@ interface IpcApi {
     updateClaudeSettings(patch: Partial<ClaudeHarnessSettings> & {
         executablePath?: string | null;
     }): Promise<AppSettings>;
+    /** Persist a custom executable path for Claude / Codex / OpenCode / Brightsy. */
+    updateAgentExecutable(agent: CliAgentKind, executablePath: string | null): Promise<AppSettings>;
     /** Native file picker for a Claude Code executable override. */
     pickClaudeExecutable(): Promise<string | null>;
+    /** Native file picker for a CLI agent executable override. */
+    pickAgentExecutable(agent: CliAgentKind): Promise<string | null>;
     /** Absolute path for PATH `claude`, or null if missing. */
     resolveSystemClaudePath(): Promise<string | null>;
+    /** Absolute path for PATH binary of a CLI agent, or null if missing. */
+    resolveSystemAgentPath(agent: CliAgentKind): Promise<string | null>;
     /** Ensure `~/.claude/settings.json` exists and open it in the OS default app. */
     openClaudeUserSettings(): Promise<void>;
     listBrightsyChatTargets(): Promise<BrightsyChatTargets>;
@@ -3326,6 +3423,24 @@ declare const SIDEBOARD_MCP_ALLOWED_TOOLS: readonly ["mcp__sideboard", "mcp__sid
 declare const BRIGHTSY_MCP_ALLOWED_TOOLS: readonly ["mcp__brightsy", "mcp__brightsy__*"];
 /** True when ~/.brightsy/config.json has a usable login session. */
 declare function isBrightsyConnected(): boolean;
+/** True when the user explicitly named Brightsy (e.g. "use Brightsy to …"). */
+declare function promptMentionsBrightsy(text: string | null | undefined): boolean;
+/**
+ * Worktree turns only inject Brightsy MCP when the user asked for it (or this
+ * thread already used it). Do not scan the assembled agent prompt — the
+ * artifact reminder always mentions Brightsy.
+ */
+declare function threadRequestsBrightsyMcp(thread: Pick<Thread, 'messages'> | null | undefined): boolean;
+/**
+ * Orchestration always gets Brightsy MCP when logged in. Worktree coding turns
+ * get it when Settings → “Inject Brightsy MCP on worktree agents” is on, or
+ * after “use Brightsy …” / a prior Brightsy tool / CMS pane.
+ */
+declare function shouldInjectBrightsyMcp(thread: Pick<Thread, 'messages'> | null | undefined, opts?: {
+    orchestrator?: boolean;
+    connected?: boolean;
+    alwaysOnWorktree?: boolean;
+}): boolean;
 /** Allow-tool patterns for one or more Brightsy MCP server names. */
 declare function brightsyMcpAllowedTools(serverNames: string[]): string[];
 /**
@@ -3337,4 +3452,4 @@ declare function writeInjectedMcpConfig(opts: {
     includeBrightsy?: boolean;
 }): Promise<string | null>;
 
-export { ATTACHMENTS_DIR, type ActiveRun, type AddStackLayerInput, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentModelCatalog, type AgentModelInfo, type AgentSetupActionResult, type AgentSetupInfo, type AgentSetupKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLAUDE_MODEL_CATALOG, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ComposerFileBuffer, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateStackInput, type CreateThreadInput, type CreateWorktreeResult, type CursorModelInfo, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DefaultsAppSettings, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GhStackStatus, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type InitStackFromThreadInput, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, LEGACY_ATTACHMENTS_DIR, LEGACY_PLAN_FILE_REL, LEGACY_REVIEW_REQUEST_PATH, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, ORCHESTRATOR_AGENT_KINDS, type OpenPrStackLayersInput, type OpenStackLayerInput, type OpenStackLayerResult, type OrchestrationQuotaOnLimit, Orchestrator, type OrchestratorAgentKind, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PASTE_ATTACH_MIN_CHARS, PASTE_ATTACH_MIN_LINES, PLAN_FILE_NAME, PLAN_FILE_REL, PLAN_MODE_INSTRUCTION, type PendingPlanQuestions, type PlanQuestion, type PlanQuestionAnswer, type PlanQuestionOption, type PlanToolPartLike, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type PrStack, type PrStackLayer, type PresentedPlan, REPO_REVIEW_NAME, REPO_REVIEW_PATH, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, type ResolvedReviewGuidelines, type ReviewGuidelinesSource, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, THINKING_EFFORTS, type TeamName, type ThinkingEffort, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type ToolPartLike, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addPrStackLayer, addStackLayerFromThread, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, assertOrchestratorCapableAgent, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, attachmentsGitignoreBody, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildPastedTextAttachment, buildReviewRequestAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, checkoutPrStackLayer, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, coerceOrchestratorAgent, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createExistingBranchWorktree, createGlobalChat, createOrUpdatePr, createPrStack, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectGhStack, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureReviewRequestFile, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractPendingPlanQuestions, extractPresentedPlan, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, findThreadForStackLayer, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatPlanQuestionAnswers, formatPlanQuestionsForChat, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getAgentSetupInfo, getBrightsySession, getDefaultAgent, getDefaultEffort, getDefaultFast, getDefaultModel, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getPrStack, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initPrStack, initStackFromThread, initializeGitRepository, inspectGitWorktree, installAgent, isAskUserToolName, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isInPrStack, isLinearConnected, isOrchestratorCapableAgent, isOrchestratorThread, isPidAlive, isPlaceholderBranch, isPresentPlanToolName, isSessionQuotaLimit, isSideboardScratchPath, isThinkingEffort, isWorkspaceScratchPath, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listModelsForAgent, listOpencodeModels, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, loginAgent, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergePrStack, mergeUsage, nextPastedTextName, nextThinkingEffort, normalizeParseResult, normalizeThinkingEffort, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, openPrStackLayers, openStackLayer, opencodeAdapter, orchestrationQuotaFallbackAgent, orchestrationQuotaOnLimit, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGhStackViewJson, parseGithubSlugFromRemoteUrl, parseMcpList, parsePlanQuestionsInput, parseSessionQuotaResetAt, partsToAssistantText, pastedTextStats, permissionMode, planFileAbs, previewLand, pushBranch, readExistingReviewRequestFile, readPlanFile, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requestReview, requireAgent, resetGhStackDetectCache, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGhAuthToken, resolveGithubRepoSlug, resolveNewThreadOptions, resolvePlanMarkdown, resolvePrSelector, resolveQuotaFallbackAgent, resolveRepoRoot, resolveReviewGuidelines, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, shouldRefreshReviewRequestTemplate, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stackAgentDefaultsFrom, stackIdFrom, stackMergeReadiness, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, submitPrStack, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, thinkingEffortBars, thinkingEffortLabel, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateDefaultsSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writePlanFile, writeThread, writeWorktreeFile };
+export { ATTACHMENTS_DIR, type ActiveRun, type AddStackLayerInput, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentModelCatalog, type AgentModelInfo, type AgentSetupActionResult, type AgentSetupInfo, type AgentSetupKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLAUDE_MODEL_CATALOG, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CliAgentKind, type CliExecutableSettings, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ComposerFileBuffer, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateStackInput, type CreateThreadInput, type CreateWorktreeResult, type CursorModelInfo, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DefaultsAppSettings, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GhStackStatus, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type InitStackFromThreadInput, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, LEGACY_ATTACHMENTS_DIR, LEGACY_PLAN_FILE_REL, LEGACY_REVIEW_REQUEST_PATH, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, ORCHESTRATOR_AGENT_KINDS, type OpenPrStackLayersInput, type OpenStackLayerInput, type OpenStackLayerResult, type OrchestrationQuotaOnLimit, Orchestrator, type OrchestratorAgentKind, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PASTE_ATTACH_MIN_CHARS, PASTE_ATTACH_MIN_LINES, PLAN_FILE_NAME, PLAN_FILE_REL, PLAN_MODE_INSTRUCTION, type PendingPlanQuestions, type PlanQuestion, type PlanQuestionAnswer, type PlanQuestionOption, type PlanToolPartLike, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type PrStack, type PrStackLayer, type PresentedPlan, REPO_REVIEW_NAME, REPO_REVIEW_PATH, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, type ResolvedReviewGuidelines, type ReviewGuidelinesSource, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, SIDEBOARD_MCP_PROFILE_ENV, type ScriptHandle, type SideboardMcpProfile, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, THINKING_EFFORTS, type TeamName, type ThinkingEffort, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type ToolPartLike, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addPrStackLayer, addStackLayerFromThread, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, assertOrchestratorCapableAgent, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, attachmentsGitignoreBody, autoArchiveOnMergeEnabled, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyInjectWorktreeMcpEnabled, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildPastedTextAttachment, buildReviewRequestAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, checkoutPrStackLayer, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, coerceOrchestratorAgent, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createExistingBranchWorktree, createGlobalChat, createOrUpdatePr, createPrStack, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectGhStack, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, dropCachedPrefixOnResume, encodeBrightsyTarget, enrichPathWithNpmGlobalBin, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureReviewRequestFile, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractPendingPlanQuestions, extractPresentedPlan, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, findThreadForStackLayer, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatPlanQuestionAnswers, formatPlanQuestionsForChat, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, formatWorktreeReminder, getAdapter, getAgentSetupInfo, getBrightsySession, getDefaultAgent, getDefaultEffort, getDefaultFast, getDefaultModel, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getPrStack, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initPrStack, initStackFromThread, initializeGitRepository, inspectGitWorktree, installAgent, isAskUserToolName, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isInPrStack, isLinearConnected, isOrchestratorCapableAgent, isOrchestratorThread, isPidAlive, isPlaceholderBranch, isPresentPlanToolName, isSessionQuotaLimit, isSideboardScratchPath, isThinkingEffort, isWorkspaceScratchPath, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listModelsForAgent, listOpencodeModels, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, loginAgent, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergePrStack, mergeUsage, nextPastedTextName, nextThinkingEffort, normalizeParseResult, normalizeThinkingEffort, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, openPrStackLayers, openStackLayer, opencodeAdapter, orchestrationQuotaFallbackAgent, orchestrationQuotaOnLimit, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGhStackViewJson, parseGithubSlugFromRemoteUrl, parseMcpList, parsePlanQuestionsInput, parseSessionQuotaResetAt, partsToAssistantText, pastedTextStats, permissionMode, planFileAbs, posixShellSingleQuote, prepareTerminalCommand, previewLand, promptMentionsBrightsy, pushBranch, readExistingReviewRequestFile, readPlanFile, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requestReview, requireAgent, resetGhStackDetectCache, resolveAgentExecutable, resolveClaudeExecutable, resolveCommandBinarySync, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGhAuthToken, resolveGithubRepoSlug, resolveLoginCommand, resolveNewThreadOptions, resolvePlanMarkdown, resolvePrSelector, resolveQuotaFallbackAgent, resolveRepoRoot, resolveReviewGuidelines, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, shouldInjectBrightsyMcp, shouldRefreshReviewRequestTemplate, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardMcpProfile, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stackAgentDefaultsFrom, stackIdFrom, stackMergeReadiness, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, submitPrStack, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, thinkingEffortBars, thinkingEffortLabel, threadDisplayLabel, threadFilePath, threadLockPath, threadRequestsBrightsyMcp, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAgentExecutable, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateCodexSettings, updateDefaultsSettings, updateIntegrationsSettings, updateOpencodeSettings, updateThread, validateLinearApiKey, withAgentInstructions, withExportedPath, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writePlanFile, writeThread, writeWorktreeFile };

package/dist/index.d.ts

@@ -113,6 +113,18 @@ interface Thread {
     prUrl: string | null;
     /** Cached PR title for Conductor-style sidebar labels (PR title > branch). */
     prTitle: string | null;
+    /**
+     * Cached GitHub PR lifecycle from the last `getPrMeta` / merge
+     * (`OPEN` | `MERGED` | `CLOSED`, etc.). Used for purple “done” sidebar
+     * styling and Conductor-style auto-archive-on-merge.
+     */
+    prState: string | null;
+    /**
+     * When true, skip auto-archive if the PR is already MERGED (set on restore
+     * so unarchiving a merged workspace does not immediately re-archive).
+     * Cleared when `prState` becomes a non-merged open state again.
+     */
+    skipAutoArchiveOnMerge?: boolean;
     /**
      * Stable id for a GitHub PR stack this thread belongs to (shared across layer worktrees).
      * Null when not part of a stack.
@@ -581,14 +593,27 @@ interface ClaudeHarnessSettings {
     /** When true, pass `--chrome` on Claude turns. */
     chromeEnabled?: boolean;
 }
+/** Optional absolute path override for a CLI agent binary. */
+interface CliExecutableSettings {
+    /** Absolute path to the CLI. Empty/omitted = default name on PATH. */
+    executablePath?: string;
+}
 /** Local agent that runs the Brightsy cloud coordinator. */
 type BrightsyCloudConnectAgent = 'claude' | 'codex' | 'opencode' | 'cursor';
 /** Brightsy cloud remote-orchestrator preferences (Slack / Discord / Teams). */
 interface BrightsyHarnessSettings {
+    /** Absolute path to the Brightsy CLI. Empty/omitted = `brightsy` on PATH. */
+    executablePath?: string;
     /** When true, desktop app polls Brightsy for Sideboard cloud tasks. */
     cloudConnectEnabled?: boolean;
     /** Local agent used for the cloud coordinator (not Brightsy itself). */
     cloudConnectAgent?: BrightsyCloudConnectAgent;
+    /**
+     * When true, inject Brightsy MCP on every worktree agent turn (Claude / Codex /
+     * Cursor / OpenCode) if logged in. Default off: only when the user asks
+     * (“use Brightsy…”) or the thread already used it. Orchestration always injects.
+     */
+    injectWorktreeMcp?: boolean;
 }
 /** Preferred issue tracker for Create-from / Link issue. */
 type IssueSource = 'linear' | 'github';
@@ -636,6 +661,11 @@ interface AdvancedAppSettings {
      * Conductor: `git.delete_branch_on_archive` (default off).
      */
     deleteBranchOnPurge?: boolean;
+    /**
+     * When a linked PR becomes MERGED, archive the worktree’s chats.
+     * Conductor: auto-archive on merge (opt-in; default off).
+     */
+    autoArchiveOnMerge?: boolean;
     /** Max concurrent agent turns across the orchestrator (default 3). */
     maxConcurrent?: number;
     /**
@@ -663,6 +693,10 @@ interface AppSettings {
     environment: Record<string, string>;
     /** Claude Code–specific harness settings. */
     claude: ClaudeHarnessSettings;
+    /** Codex CLI executable override. */
+    codex: CliExecutableSettings;
+    /** OpenCode CLI executable override. */
+    opencode: CliExecutableSettings;
     /** Brightsy cloud connect preferences (Slack / Discord / Teams). */
     brightsy: BrightsyHarnessSettings;
     /** GitHub / Linear connections and issue-source preference. */
@@ -683,8 +717,16 @@ declare function updateClaudeSettings(patch: {
     chromeEnabled?: boolean;
 }): AppSettings;
 declare function updateBrightsySettings(patch: {
+    executablePath?: string | null;
     cloudConnectEnabled?: boolean;
     cloudConnectAgent?: BrightsyCloudConnectAgent | null;
+    injectWorktreeMcp?: boolean;
+}): AppSettings;
+declare function updateCodexSettings(patch: {
+    executablePath?: string | null;
+}): AppSettings;
+declare function updateOpencodeSettings(patch: {
+    executablePath?: string | null;
 }): AppSettings;
 declare function updateIntegrationsSettings(patch: {
     linearApiKey?: string | null;
@@ -739,6 +781,8 @@ declare function getIssueSource(settings?: AppSettings): IssueSource;
 declare function resolveEffectiveIssueSource(settings?: AppSettings): IssueSource;
 declare function getLinearApiKey(settings?: AppSettings): string | null;
 declare function brightsyCloudConnectEnabled(settings?: AppSettings): boolean;
+/** Default off — worktree agents only get Brightsy MCP on ask / prior use. */
+declare function brightsyInjectWorktreeMcpEnabled(settings?: AppSettings): boolean;
 /**
  * Local agent for the Brightsy cloud coordinator.
  * Prefer Account → Default agent when it can run orchestration (Claude / Cursor /
@@ -753,6 +797,8 @@ declare function autoRunAfterSetupEnabled(settings?: AppSettings): boolean;
 declare function caffeinateWhileRunningEnabled(settings?: AppSettings): boolean;
 declare function caffeinateWhileCloudConnectEnabled(settings?: AppSettings): boolean;
 declare function deleteBranchOnPurgeEnabled(settings?: AppSettings): boolean;
+/** Conductor-style opt-in — default off. */
+declare function autoArchiveOnMergeEnabled(settings?: AppSettings): boolean;
 declare function autoCleanupOrphansEnabled(settings?: AppSettings): boolean;
 /** Default: switch to another agent (Auto) when orchestration hits a session limit. */
 declare function orchestrationQuotaOnLimit(settings?: AppSettings): OrchestrationQuotaOnLimit;
@@ -761,6 +807,11 @@ declare function orchestrationQuotaFallbackAgent(settings?: AppSettings): AgentK
 declare function maxConcurrentAgents(settings?: AppSettings): number;
 /** Binary name or absolute path used to spawn Claude Code. */
 declare function resolveClaudeExecutable(settings?: AppSettings): string;
+/** CLI agents that support a custom executable path override. */
+type CliAgentKind = 'claude' | 'codex' | 'opencode' | 'brightsy';
+/** Binary name or absolute path for a CLI agent (custom path when set). */
+declare function resolveAgentExecutable(agent: CliAgentKind, settings?: AppSettings): string;
+declare function updateAgentExecutable(agent: CliAgentKind, executablePath: string | null): AppSettings;
 declare function claudeChromeEnabled(settings?: AppSettings): boolean;
 /**
  * Apply Sideboard-managed environment onto a process env object.
@@ -783,7 +834,7 @@ declare function resolveThreadEffort(raw: {
     fast?: unknown;
 }): ThinkingEffort;
 declare function normalizeThread(raw: Thread): Thread;
-declare function createEmptyThread(partial: Omit<Thread, 'id' | 'createdAt' | 'updatedAt' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'attachments'> & Partial<Pick<Thread, 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'attachments'>>): Thread;
+declare function createEmptyThread(partial: Omit<Thread, 'id' | 'createdAt' | 'updatedAt' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'prState' | 'skipAutoArchiveOnMerge' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'attachments'> & Partial<Pick<Thread, 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'prState' | 'skipAutoArchiveOnMerge' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'attachments'>>): Thread;
 declare function withThreadLock<T>(id: string, fn: () => Promise<T>): Promise<T>;
 declare function readThread(id: string): Thread | null;
 declare function writeThread(thread: Thread): void;
@@ -1209,6 +1260,11 @@ interface AgentTurnInput {
     prompt: string;
 }
 declare function normalizeTurnInput(input: string | AgentTurnInput): Required<Pick<AgentTurnInput, 'prompt'>> & AgentTurnInput;
+/**
+ * Resumed CLI sessions already hold history + first-turn prefix. Re-sending
+ * cachedPrefix (worktree playbook, AGENTS.md, artifact docs) doubles tokens.
+ */
+declare function dropCachedPrefixOnResume(input: string | AgentTurnInput, sessionId: string | null | undefined): AgentTurnInput;
 /**
  * Flatten to a single string for CLIs that don't accept cache_control blocks
  * (Codex today; OpenCode `run` is plain text — OpenCode applies provider caching
@@ -1475,6 +1531,21 @@ declare function coerceOrchestratorAgent(agent: AgentKind | null | undefined, fa
  * once at process start (and before agent spawns) so adapters can resolve CLIs.
  */
 declare function ensureAgentPath(env?: NodeJS.ProcessEnv): string;
+/**
+ * Prepend the active `npm prefix -g`/bin dir (where `npm i -g @openai/codex`
+ * lands). Electron often finds this via ensureAgentPath heuristics, but a
+ * fresh Terminal window may not — causing "codex: command not found" on login.
+ */
+declare function enrichPathWithNpmGlobalBin(env?: NodeJS.ProcessEnv): string;
+/** Escape a value for use inside a POSIX single-quoted string. */
+declare function posixShellSingleQuote(value: string): string;
+/**
+ * Rewrite `codex login` → `/abs/path/codex login` when `which` can see the bin
+ * on the enriched Electron PATH.
+ */
+declare function resolveCommandBinarySync(command: string, whichPath: string | null | undefined): string;
+/** `export PATH='…'; <command>` so Terminal inherits Electron’s enriched PATH. */
+declare function withExportedPath(command: string, pathValue: string): string;
 
 type AgentSetupKind = 'cli' | 'api-key' | 'bundled-sdk';
 interface AgentSetupInfo {
@@ -1502,6 +1573,14 @@ interface AgentSetupActionResult {
 }
 declare function getAgentSetupInfo(agent: AgentKind): AgentSetupInfo;
 declare function listAgentSetupInfo(): AgentSetupInfo[];
+/** Rewrite login command to honor a custom executable path override. */
+declare function resolveLoginCommand(agent: AgentKind): string | null;
+/**
+ * Make a Terminal command resolve the same binaries Electron sees after
+ * `npm i -g` (absolute path + exported PATH). Avoids "codex: command not found"
+ * when Terminal’s login shell lacks the npm global bin.
+ */
+declare function prepareTerminalCommand(command: string): Promise<string>;
 /**
  * Open an interactive shell command in the system terminal (macOS Terminal.app,
  * Linux gnome-terminal/x-terminal-emulator, Windows cmd).
@@ -1594,6 +1673,8 @@ declare function formatWorktreeDirective(thread: Pick<Thread, 'worktreePath' | '
  * Tell agents how Sideboard renders Claude-style artifacts (side column).
  * Claude Code has no claude.ai `artifact` tool — fences / present_artifact instead.
  */
+/** Short isolation line on every worktree turn (survives CLI resume). */
+declare function formatWorktreeReminder(): string;
 declare function formatArtifactDirective(): string;
 interface AgentInstructionFile {
     relativePath: string;
@@ -2392,6 +2473,11 @@ declare class Orchestrator {
     private withPrSelector;
     getPrChecks(threadRef: string): Promise<PrCheckRun[] | null>;
     getPrMeta(threadRef: string): Promise<PrMeta | null>;
+    /**
+     * Persist PR URL/title/state and Conductor-style auto-archive when the PR
+     * first becomes MERGED.
+     */
+    private persistPrMetaAndMaybeArchive;
     getPrStack(threadRef: string): Promise<PrStack | null>;
     /** Open worktrees for all (or one) stack layers discovered from a thread. */
     openPrStackLayers(threadRef: string, opts?: {
@@ -2713,6 +2799,11 @@ declare function cloneRepoIntoSideboard(opts: {
  */
 declare function startMcpServer(): Promise<void>;
 
+/** Injected Sideboard MCP: worktree turns list UI tools only; orchestration gets the fleet. */
+type SideboardMcpProfile = 'worktree' | 'orchestration';
+declare const SIDEBOARD_MCP_PROFILE_ENV = "SIDEBOARD_MCP_PROFILE";
+declare function sideboardMcpProfile(env?: NodeJS.ProcessEnv): SideboardMcpProfile;
+
 interface BrightsyLocalConfig {
     access_token: string;
     refresh_token?: string;
@@ -2784,10 +2875,16 @@ interface IpcApi {
     updateClaudeSettings(patch: Partial<ClaudeHarnessSettings> & {
         executablePath?: string | null;
     }): Promise<AppSettings>;
+    /** Persist a custom executable path for Claude / Codex / OpenCode / Brightsy. */
+    updateAgentExecutable(agent: CliAgentKind, executablePath: string | null): Promise<AppSettings>;
     /** Native file picker for a Claude Code executable override. */
     pickClaudeExecutable(): Promise<string | null>;
+    /** Native file picker for a CLI agent executable override. */
+    pickAgentExecutable(agent: CliAgentKind): Promise<string | null>;
     /** Absolute path for PATH `claude`, or null if missing. */
     resolveSystemClaudePath(): Promise<string | null>;
+    /** Absolute path for PATH binary of a CLI agent, or null if missing. */
+    resolveSystemAgentPath(agent: CliAgentKind): Promise<string | null>;
     /** Ensure `~/.claude/settings.json` exists and open it in the OS default app. */
     openClaudeUserSettings(): Promise<void>;
     listBrightsyChatTargets(): Promise<BrightsyChatTargets>;
@@ -3326,6 +3423,24 @@ declare const SIDEBOARD_MCP_ALLOWED_TOOLS: readonly ["mcp__sideboard", "mcp__sid
 declare const BRIGHTSY_MCP_ALLOWED_TOOLS: readonly ["mcp__brightsy", "mcp__brightsy__*"];
 /** True when ~/.brightsy/config.json has a usable login session. */
 declare function isBrightsyConnected(): boolean;
+/** True when the user explicitly named Brightsy (e.g. "use Brightsy to …"). */
+declare function promptMentionsBrightsy(text: string | null | undefined): boolean;
+/**
+ * Worktree turns only inject Brightsy MCP when the user asked for it (or this
+ * thread already used it). Do not scan the assembled agent prompt — the
+ * artifact reminder always mentions Brightsy.
+ */
+declare function threadRequestsBrightsyMcp(thread: Pick<Thread, 'messages'> | null | undefined): boolean;
+/**
+ * Orchestration always gets Brightsy MCP when logged in. Worktree coding turns
+ * get it when Settings → “Inject Brightsy MCP on worktree agents” is on, or
+ * after “use Brightsy …” / a prior Brightsy tool / CMS pane.
+ */
+declare function shouldInjectBrightsyMcp(thread: Pick<Thread, 'messages'> | null | undefined, opts?: {
+    orchestrator?: boolean;
+    connected?: boolean;
+    alwaysOnWorktree?: boolean;
+}): boolean;
 /** Allow-tool patterns for one or more Brightsy MCP server names. */
 declare function brightsyMcpAllowedTools(serverNames: string[]): string[];
 /**
@@ -3337,4 +3452,4 @@ declare function writeInjectedMcpConfig(opts: {
     includeBrightsy?: boolean;
 }): Promise<string | null>;
 
-export { ATTACHMENTS_DIR, type ActiveRun, type AddStackLayerInput, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentModelCatalog, type AgentModelInfo, type AgentSetupActionResult, type AgentSetupInfo, type AgentSetupKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLAUDE_MODEL_CATALOG, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ComposerFileBuffer, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateStackInput, type CreateThreadInput, type CreateWorktreeResult, type CursorModelInfo, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DefaultsAppSettings, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GhStackStatus, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type InitStackFromThreadInput, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, LEGACY_ATTACHMENTS_DIR, LEGACY_PLAN_FILE_REL, LEGACY_REVIEW_REQUEST_PATH, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, ORCHESTRATOR_AGENT_KINDS, type OpenPrStackLayersInput, type OpenStackLayerInput, type OpenStackLayerResult, type OrchestrationQuotaOnLimit, Orchestrator, type OrchestratorAgentKind, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PASTE_ATTACH_MIN_CHARS, PASTE_ATTACH_MIN_LINES, PLAN_FILE_NAME, PLAN_FILE_REL, PLAN_MODE_INSTRUCTION, type PendingPlanQuestions, type PlanQuestion, type PlanQuestionAnswer, type PlanQuestionOption, type PlanToolPartLike, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type PrStack, type PrStackLayer, type PresentedPlan, REPO_REVIEW_NAME, REPO_REVIEW_PATH, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, type ResolvedReviewGuidelines, type ReviewGuidelinesSource, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, THINKING_EFFORTS, type TeamName, type ThinkingEffort, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type ToolPartLike, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addPrStackLayer, addStackLayerFromThread, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, assertOrchestratorCapableAgent, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, attachmentsGitignoreBody, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildPastedTextAttachment, buildReviewRequestAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, checkoutPrStackLayer, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, coerceOrchestratorAgent, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createExistingBranchWorktree, createGlobalChat, createOrUpdatePr, createPrStack, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectGhStack, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureReviewRequestFile, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractPendingPlanQuestions, extractPresentedPlan, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, findThreadForStackLayer, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatPlanQuestionAnswers, formatPlanQuestionsForChat, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getAgentSetupInfo, getBrightsySession, getDefaultAgent, getDefaultEffort, getDefaultFast, getDefaultModel, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getPrStack, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initPrStack, initStackFromThread, initializeGitRepository, inspectGitWorktree, installAgent, isAskUserToolName, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isInPrStack, isLinearConnected, isOrchestratorCapableAgent, isOrchestratorThread, isPidAlive, isPlaceholderBranch, isPresentPlanToolName, isSessionQuotaLimit, isSideboardScratchPath, isThinkingEffort, isWorkspaceScratchPath, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listModelsForAgent, listOpencodeModels, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, loginAgent, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergePrStack, mergeUsage, nextPastedTextName, nextThinkingEffort, normalizeParseResult, normalizeThinkingEffort, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, openPrStackLayers, openStackLayer, opencodeAdapter, orchestrationQuotaFallbackAgent, orchestrationQuotaOnLimit, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGhStackViewJson, parseGithubSlugFromRemoteUrl, parseMcpList, parsePlanQuestionsInput, parseSessionQuotaResetAt, partsToAssistantText, pastedTextStats, permissionMode, planFileAbs, previewLand, pushBranch, readExistingReviewRequestFile, readPlanFile, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requestReview, requireAgent, resetGhStackDetectCache, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGhAuthToken, resolveGithubRepoSlug, resolveNewThreadOptions, resolvePlanMarkdown, resolvePrSelector, resolveQuotaFallbackAgent, resolveRepoRoot, resolveReviewGuidelines, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, shouldRefreshReviewRequestTemplate, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stackAgentDefaultsFrom, stackIdFrom, stackMergeReadiness, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, submitPrStack, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, thinkingEffortBars, thinkingEffortLabel, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateDefaultsSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writePlanFile, writeThread, writeWorktreeFile };
+export { ATTACHMENTS_DIR, type ActiveRun, type AddStackLayerInput, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentModelCatalog, type AgentModelInfo, type AgentSetupActionResult, type AgentSetupInfo, type AgentSetupKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLAUDE_MODEL_CATALOG, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CliAgentKind, type CliExecutableSettings, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ComposerFileBuffer, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateStackInput, type CreateThreadInput, type CreateWorktreeResult, type CursorModelInfo, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DefaultsAppSettings, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GhStackStatus, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type InitStackFromThreadInput, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, LEGACY_ATTACHMENTS_DIR, LEGACY_PLAN_FILE_REL, LEGACY_REVIEW_REQUEST_PATH, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, ORCHESTRATOR_AGENT_KINDS, type OpenPrStackLayersInput, type OpenStackLayerInput, type OpenStackLayerResult, type OrchestrationQuotaOnLimit, Orchestrator, type OrchestratorAgentKind, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PASTE_ATTACH_MIN_CHARS, PASTE_ATTACH_MIN_LINES, PLAN_FILE_NAME, PLAN_FILE_REL, PLAN_MODE_INSTRUCTION, type PendingPlanQuestions, type PlanQuestion, type PlanQuestionAnswer, type PlanQuestionOption, type PlanToolPartLike, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type PrStack, type PrStackLayer, type PresentedPlan, REPO_REVIEW_NAME, REPO_REVIEW_PATH, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, type ResolvedReviewGuidelines, type ReviewGuidelinesSource, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, SIDEBOARD_MCP_PROFILE_ENV, type ScriptHandle, type SideboardMcpProfile, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, THINKING_EFFORTS, type TeamName, type ThinkingEffort, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type ToolPartLike, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addPrStackLayer, addStackLayerFromThread, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, assertOrchestratorCapableAgent, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, attachmentsGitignoreBody, autoArchiveOnMergeEnabled, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyInjectWorktreeMcpEnabled, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildPastedTextAttachment, buildReviewRequestAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, checkoutPrStackLayer, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, coerceOrchestratorAgent, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createExistingBranchWorktree, createGlobalChat, createOrUpdatePr, createPrStack, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectGhStack, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, dropCachedPrefixOnResume, encodeBrightsyTarget, enrichPathWithNpmGlobalBin, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureReviewRequestFile, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractPendingPlanQuestions, extractPresentedPlan, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, findThreadForStackLayer, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatPlanQuestionAnswers, formatPlanQuestionsForChat, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, formatWorktreeReminder, getAdapter, getAgentSetupInfo, getBrightsySession, getDefaultAgent, getDefaultEffort, getDefaultFast, getDefaultModel, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getPrStack, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initPrStack, initStackFromThread, initializeGitRepository, inspectGitWorktree, installAgent, isAskUserToolName, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isInPrStack, isLinearConnected, isOrchestratorCapableAgent, isOrchestratorThread, isPidAlive, isPlaceholderBranch, isPresentPlanToolName, isSessionQuotaLimit, isSideboardScratchPath, isThinkingEffort, isWorkspaceScratchPath, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listModelsForAgent, listOpencodeModels, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, loginAgent, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergePrStack, mergeUsage, nextPastedTextName, nextThinkingEffort, normalizeParseResult, normalizeThinkingEffort, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, openPrStackLayers, openStackLayer, opencodeAdapter, orchestrationQuotaFallbackAgent, orchestrationQuotaOnLimit, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGhStackViewJson, parseGithubSlugFromRemoteUrl, parseMcpList, parsePlanQuestionsInput, parseSessionQuotaResetAt, partsToAssistantText, pastedTextStats, permissionMode, planFileAbs, posixShellSingleQuote, prepareTerminalCommand, previewLand, promptMentionsBrightsy, pushBranch, readExistingReviewRequestFile, readPlanFile, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requestReview, requireAgent, resetGhStackDetectCache, resolveAgentExecutable, resolveClaudeExecutable, resolveCommandBinarySync, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGhAuthToken, resolveGithubRepoSlug, resolveLoginCommand, resolveNewThreadOptions, resolvePlanMarkdown, resolvePrSelector, resolveQuotaFallbackAgent, resolveRepoRoot, resolveReviewGuidelines, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, shouldInjectBrightsyMcp, shouldRefreshReviewRequestTemplate, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardMcpProfile, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stackAgentDefaultsFrom, stackIdFrom, stackMergeReadiness, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, submitPrStack, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, thinkingEffortBars, thinkingEffortLabel, threadDisplayLabel, threadFilePath, threadLockPath, threadRequestsBrightsyMcp, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAgentExecutable, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateCodexSettings, updateDefaultsSettings, updateIntegrationsSettings, updateOpencodeSettings, updateThread, validateLinearApiKey, withAgentInstructions, withExportedPath, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writePlanFile, writeThread, writeWorktreeFile };