@sideboard-ai/core 0.1.67 → 0.1.71

package/dist/index.d.cts

@@ -284,6 +284,8 @@ interface PrMeta {
     reviewDecision: string | null;
     baseRefName: string;
     headRefName: string;
+    /** True when the PR is sitting in a GitHub merge queue. */
+    isInMergeQueue: boolean;
 }
 /** One layer in a GitHub PR stack (bottom = position 1). */
 interface PrStackLayer {
@@ -367,6 +369,8 @@ interface DiffResult {
     hasLastTurnBase: boolean;
     /** Recent commits on the branch (vs merge-base), for the Commits flyout. */
     commits: DiffCommit[];
+    /** Resolved merge-base SHA when comparing the branch to the default. */
+    mergeBase?: string | null;
 }
 interface LandPreview {
     branch: string;
@@ -600,7 +604,7 @@ interface CliExecutableSettings {
 }
 /** Local agent that runs the Brightsy cloud coordinator. */
 type BrightsyCloudConnectAgent = 'claude' | 'codex' | 'opencode' | 'cursor';
-/** Brightsy cloud remote-orchestrator preferences (Slack / Discord / Teams). */
+/** Brightsy cloud remote-orchestrator preferences. */
 interface BrightsyHarnessSettings {
     /** Absolute path to the Brightsy CLI. Empty/omitted = `brightsy` on PATH. */
     executablePath?: string;
@@ -619,16 +623,48 @@ interface BrightsyHarnessSettings {
 type IssueSource = 'linear' | 'github';
 /**
  * Sideboard-owned third-party connections (Account / Integrations).
- * GitHub uses machine `gh` auth; Linear uses a stored API key.
+ * GitHub uses machine `gh` auth; Linear uses OAuth (or a stored API key).
  */
 interface IntegrationsSettings {
-    /** Linear personal API key (https://linear.app/settings/api). */
+    /** Linear personal API key (https://linear.app/settings/api). Fallback when OAuth is unused. */
     linearApiKey?: string;
+    /** Linear OAuth access token (Account → Linear → Connect via browser). */
+    linearAccessToken?: string;
+    /** Linear OAuth refresh token (rotated on each refresh). */
+    linearRefreshToken?: string;
+    /** Epoch ms when {@link IntegrationsSettings.linearAccessToken} expires. */
+    linearTokenExpiresAt?: number;
+    /** Linear OAuth app Client ID override (else baked / env). */
+    linearClientId?: string;
+    /** Linear OAuth app Client Secret override (optional with PKCE). */
+    linearClientSecret?: string;
+    /** Display name of the connected Linear user (non-secret). */
+    linearViewerName?: string;
+    /** Display name of the connected Linear workspace (non-secret). */
+    linearOrganizationName?: string;
     /**
      * Preferred issue source for Create-from / Link issue (default: GitHub).
-     * When `linear` but no API key, runtime falls back to GitHub Issues.
+     * When `linear` but not connected, runtime falls back to GitHub Issues.
      */
     issueSource?: IssueSource;
+    /** Slack app Client ID for browser OAuth (Account → Slack). */
+    slackClientId?: string;
+    /** Slack app Client Secret for browser OAuth. */
+    slackClientSecret?: string;
+    /**
+     * Slack app-level token (`xapp-…`, `connections:write`) for Socket Mode listen.
+     * App-wide — not per workspace.
+     */
+    slackAppToken?: string;
+    /** When true, desktop/CLI listen for Slack DMs and @mentions via Socket Mode. */
+    slackListenEnabled?: boolean;
+    /**
+     * Stable per-Mac id for the Slack relay (Personal vs Work can both stay online).
+     * Generated once; do not copy between machines.
+     */
+    slackDeviceId?: string;
+    /** Human label for this Mac destination, e.g. Personal / Work. */
+    slackDeviceLabel?: string;
 }
 /**
  * Conductor-inspired power-user preferences (Settings → Advanced).
@@ -652,8 +688,12 @@ interface AdvancedAppSettings {
      */
     caffeinateWhileRunning?: boolean;
     /**
-     * Keep the Mac awake with `caffeinate` while Brightsy cloud connect is listening
-     * (so Slack/Discord/Teams tasks can be polled). Default off.
+     * Keep the Mac awake with `caffeinate` while Slack Listen is connected
+     * (so Personal/Work stay reachable with the lid closed on AC). Default off.
+     */
+    caffeinateWhileSlackListen?: boolean;
+    /**
+     * @deprecated Prefer `caffeinateWhileSlackListen`. Still read on load for migration.
      */
     caffeinateWhileCloudConnect?: boolean;
     /**
@@ -697,7 +737,7 @@ interface AppSettings {
     codex: CliExecutableSettings;
     /** OpenCode CLI executable override. */
     opencode: CliExecutableSettings;
-    /** Brightsy cloud connect preferences (Slack / Discord / Teams). */
+    /** Brightsy cloud connect preferences. */
     brightsy: BrightsyHarnessSettings;
     /** GitHub / Linear connections and issue-source preference. */
     integrations: IntegrationsSettings;
@@ -706,6 +746,19 @@ interface AppSettings {
     /** Power-user / Conductor-style advanced preferences. */
     advanced: AdvancedAppSettings;
 }
+/** Integrations fields safe to send to the renderer (no token values). */
+type PublicIntegrationsSettings = Omit<IntegrationsSettings, 'linearApiKey' | 'linearAccessToken' | 'linearRefreshToken' | 'linearClientSecret' | 'slackClientSecret' | 'slackAppToken'> & {
+    /** True when Linear is connected (OAuth or API key). */
+    hasLinearApiKey: boolean;
+    hasLinearOAuth: boolean;
+    hasSlackClientSecret: boolean;
+    hasSlackAppToken: boolean;
+};
+/** Settings payload for the desktop UI. Secret values are omitted. */
+type PublicAppSettings = Omit<AppSettings, 'integrations'> & {
+    integrations: PublicIntegrationsSettings;
+};
+declare function toPublicAppSettings(settings: AppSettings): PublicAppSettings;
 declare function appSettingsPath(): string;
 /** User-level Claude Code settings file (`~/.claude/settings.json`). */
 declare function claudeUserSettingsPath(): string;
@@ -730,7 +783,15 @@ declare function updateOpencodeSettings(patch: {
 }): AppSettings;
 declare function updateIntegrationsSettings(patch: {
     linearApiKey?: string | null;
+    linearClientId?: string | null;
+    linearClientSecret?: string | null;
     issueSource?: IssueSource | null;
+    slackClientId?: string | null;
+    slackClientSecret?: string | null;
+    slackAppToken?: string | null;
+    slackListenEnabled?: boolean | null;
+    slackDeviceId?: string | null;
+    slackDeviceLabel?: string | null;
 }): AppSettings;
 declare function updateDefaultsSettings(patch: {
     agent?: AgentKind | null;
@@ -770,8 +831,18 @@ declare function resolveNewThreadOptions(overrides?: {
     effort: ThinkingEffort;
     fast: boolean;
 };
-/** True when Sideboard has a Linear API key stored. */
+/** True when Sideboard has Linear OAuth tokens or an API key stored. */
 declare function isLinearConnected(settings?: AppSettings): boolean;
+/** Persist Linear OAuth tokens after authorize or refresh. */
+declare function saveLinearOAuth(input: {
+    accessToken: string;
+    refreshToken?: string;
+    expiresIn?: number;
+    viewerName?: string;
+    organizationName?: string;
+}): AppSettings;
+/** Clear Linear OAuth tokens and API key. Does not revoke remotely. */
+declare function disconnectLinearConnection(): AppSettings;
 /** Preferred issue source (default GitHub). */
 declare function getIssueSource(settings?: AppSettings): IssueSource;
 /**
@@ -781,6 +852,21 @@ 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;
+/** Slack Socket Mode inbound (Account → Slack). Default off. */
+declare function slackListenEnabled(settings?: AppSettings): boolean;
+/**
+ * Stable per-Mac identity for the Slack relay so Personal and Work can both
+ * stay online as separate destinations.
+ */
+declare function ensureSlackDeviceIdentity(settings?: AppSettings): {
+    deviceId: string;
+    deviceLabel: string;
+};
+/**
+ * App-level token for Slack Socket Mode (`xapp-…`).
+ * Env `SIDEBOARD_SLACK_APP_TOKEN` wins over settings.
+ */
+declare function slackAppLevelToken(settings?: AppSettings): string;
 /** Default off — worktree agents only get Brightsy MCP on ask / prior use. */
 declare function brightsyInjectWorktreeMcpEnabled(settings?: AppSettings): boolean;
 /**
@@ -795,6 +881,8 @@ declare function updateAdvancedSettings(patch: Partial<AdvancedAppSettings>): Ap
 declare function autoRenameBranchEnabled(settings?: AppSettings): boolean;
 declare function autoRunAfterSetupEnabled(settings?: AppSettings): boolean;
 declare function caffeinateWhileRunningEnabled(settings?: AppSettings): boolean;
+declare function caffeinateWhileSlackListenEnabled(settings?: AppSettings): boolean;
+/** @deprecated Use caffeinateWhileSlackListenEnabled. */
 declare function caffeinateWhileCloudConnectEnabled(settings?: AppSettings): boolean;
 declare function deleteBranchOnPurgeEnabled(settings?: AppSettings): boolean;
 /** Conductor-style opt-in — default off. */
@@ -823,6 +911,33 @@ declare function applyAppEnvironment(target?: NodeJS.ProcessEnv, settings?: AppS
 declare function childEnvWithAppSettings(extra?: Record<string, string | undefined>): NodeJS.ProcessEnv;
 declare function harnessEnvKey(harness: HarnessId): string | null;
 
+interface CaffeinateHoldState {
+    held: boolean;
+    pid: number | null;
+    running: boolean;
+    platform: NodeJS.Platform;
+}
+declare function caffeinateHoldPath(): string;
+declare function getCaffeinateHold(): CaffeinateHoldState;
+/**
+ * Session hold so the Mac stays awake across orchestration turns (MCP
+ * processes exit). Detached `caffeinate` on macOS; no-op elsewhere.
+ */
+declare function setCaffeinateHold(enabled: boolean): CaffeinateHoldState;
+
+/** Desktop registers a 32-byte key from Electron safeStorage. */
+declare function setVaultMasterKey(key: Buffer | null): void;
+declare function persistVaultKeyInKeychain(key: Buffer): void;
+/** Existing Keychain vault key, if any. Does not create a new item. */
+declare function readKeychainVaultKey(): Buffer | null;
+/**
+ * AES-256-GCM key for secret files.
+ * `SIDEBOARD_SECRET_VAULT=plain` (tests) skips encryption.
+ */
+declare function resolveVaultKey(): Buffer | null;
+/** True if `path` is missing, plaintext, or decrypts with `key`. */
+declare function secureFileUnlocksWith(path: string, key: Buffer): boolean;
+
 /**
  * Resolve thinking effort for persisted threads.
  * Legacy threads only had `fast` (which also drove Claude `--effort low`);
@@ -899,6 +1014,15 @@ declare function createGlobalChat(opts: CreateGlobalChatOpts): Thread;
  */
 declare function healOrchestrationSoccerTitles(): number;
 declare function listGlobalThreads(includeArchived?: boolean): Thread[];
+/** Stable sourceRef for a Slack inbound orchestration chat (one per Slack user). */
+declare function slackCoordinatorSourceRef(teamId: string, userId: string): string;
+declare function isSlackCoordinatorThread(thread: Pick<Thread, 'sourceType' | 'sourceRef' | 'repoPath'>): boolean;
+/**
+ * Find or create a Global orchestration chat for one Slack user (team + user).
+ * Inbound DMs/@mentions from that person continue this thread — not the Brightsy
+ * cloud singleton and not other Slack users' chats.
+ */
+declare function ensureSlackCoordinator(teamId: string, userId: string, agent: AgentKind): Thread;
 /** Find or create the singleton Brightsy cloud coordinator under Global. */
 declare function ensureCloudCoordinator(agent: AgentKind): Thread;
 
@@ -1046,7 +1170,9 @@ declare function ensureGhPreferOrigin(cwd: string): Promise<void>;
  * Makerkit-style `upstream`. `GH_REPO` is the CLI's documented override.
  */
 declare function originGhRepoEnv(cwd: string): Promise<Record<string, string>>;
-declare function resolveDefaultBranch(repoPath: string): Promise<string>;
+declare function resolveDefaultBranch(repoPath: string, opts?: {
+    network?: boolean;
+}): Promise<string>;
 /**
  * Prefer `origin/<branch>` for diff/merge-base so Changes / Land don't inflate
  * against a stale local default-branch tip (common after adopting a PR).
@@ -1216,7 +1342,7 @@ declare function refreshGitHubAuth(): Promise<GitHubStatus>;
 
 /**
  * List open issues assigned to the authenticated Linear user via GraphQL.
- * Uses Sideboard-stored API key (Account → Linear), not agent MCP.
+ * Uses Sideboard-stored OAuth token or API key (Account → Linear), not agent MCP.
  */
 declare function listLinearIssuesDirect(opts?: {
     limit?: number;
@@ -1225,6 +1351,39 @@ declare function listLinearIssuesDirect(opts?: {
 /** Probe Linear with the stored key (or provided key). */
 declare function validateLinearApiKey(apiKey: string): Promise<boolean>;
 
+declare function hasBakedLinearOAuth(): boolean;
+
+/** Fixed port so the Linear OAuth redirect URI can be registered once. */
+declare const LINEAR_OAUTH_PORT = 19848;
+declare const LINEAR_OAUTH_REDIRECT = "http://127.0.0.1:19848/callback";
+/** Read-only — Sideboard lists assigned issues; it does not create them. */
+declare const LINEAR_OAUTH_SCOPES = "read";
+declare function linearOAuthCredentials(): {
+    clientId: string;
+    clientSecret: string;
+};
+declare function createLinearPkce(): {
+    verifier: string;
+    challenge: string;
+};
+declare function linearOAuthAuthorizeUrl(clientId: string, state: string, codeChallenge: string): string;
+/** Authorization header for Linear GraphQL: personal keys as-is, OAuth as Bearer. */
+declare function linearAuthorizationHeader(token: string): string;
+/**
+ * Token for Linear GraphQL: valid OAuth access token (refreshing if needed),
+ * else a stored personal API key.
+ */
+declare function getLinearAuthToken(settings?: AppSettings): Promise<string | null>;
+/**
+ * Open Linear OAuth in the browser, listen on a localhost callback, store tokens.
+ */
+declare function startLinearOAuth(opts?: {
+    openUrl?: (url: string) => void | Promise<void>;
+    timeoutMs?: number;
+}): Promise<AppSettings>;
+/** Revoke OAuth tokens (best-effort) and clear Linear credentials including API key. */
+declare function disconnectLinear(): Promise<AppSettings>;
+
 interface ListIssuesResult {
     source: IssueSource;
     /** Preference before fallback (useful for “Set up Linear” UI). */
@@ -1871,6 +2030,18 @@ interface GetDiffOptions {
     lastTurnBase?: string | null;
     /** When scope is `commits`, show only this commit's patch. */
     commitSha?: string | null;
+    /**
+     * When false, skip unified patches (file list + line counts only).
+     * Default true. The Changes file list should pass false and load one
+     * file's patch with `path` when the editor opens.
+     */
+    includePatches?: boolean;
+    /** Scope stats, commits, dirty, unpushed. Default true. */
+    includeMeta?: boolean;
+    /** Untracked files. Default follows the scope (usually on). */
+    includeUntracked?: boolean;
+    /** Only this worktree-relative path. */
+    path?: string;
 }
 /** Recent commits since merge-base (Cursor Commits submenu). */
 declare function listBranchCommits(worktreePath: string, repoPath: string, opts?: {
@@ -2432,6 +2603,11 @@ declare class Orchestrator {
     diff(threadRef: string, opts?: {
         scope?: DiffScope;
         commitSha?: string | null;
+        base?: string;
+        includePatches?: boolean;
+        includeMeta?: boolean;
+        includeUntracked?: boolean;
+        path?: string;
     }): Promise<DiffResult>;
     diffSummary(threadRef: string): Promise<{
         base: string;
@@ -2759,6 +2935,11 @@ declare function formatWorkspaceInventory(workspaces: WorkspaceInventoryEntry[])
 /** Resolve GitHub slugs for registered workspaces (best-effort). */
 declare function enrichWorkspacesWithGithub(workspaces: Workspace[]): Promise<WorkspaceInventoryEntry[]>;
 declare const COORDINATOR_TOOL_PLAYBOOK: string;
+/**
+ * Formatting rules when the coordinator reply is posted into Slack (DM / @mention).
+ * Slack uses mrkdwn, not CommonMark — `**bold**` shows literal asterisks.
+ */
+declare const SLACK_REPLY_FORMATTING: string;
 /**
  * Short identity block prepended to every orchestration turn prompt.
  * Survives Claude `--resume` (which drops cachedPrefix).
@@ -2780,8 +2961,8 @@ declare function coordinatorSystemPrompt(opts: {
     goal: string;
     parentId: string;
     workspaces: WorkspaceInventoryEntry[];
-    /** cloud = Brightsy reply framing; desktop = local Orchestration chat */
-    audience?: 'cloud' | 'desktop';
+    /** cloud = Brightsy reply framing; slack = Sideboard Slack app; desktop = local Orchestration chat */
+    audience?: 'cloud' | 'slack' | 'desktop';
 }): string;
 
 /**
@@ -2854,6 +3035,82 @@ declare function getBrightsySession(): Promise<BrightsySession>;
  */
 declare function switchBrightsyAccount(accountIdOrSlug: string): Promise<BrightsySession>;
 
+interface SlackOutboundWatch {
+    id: string;
+    teamId: string;
+    channelId: string;
+    /** Posted message ts. */
+    ts: string;
+    /** Parent thread ts (same as `ts` for top-level posts). */
+    threadTs: string;
+    kind: 'dm' | 'channel';
+    toUserId?: string;
+    toLabel: string;
+    ownerUserId?: string;
+    postedAt: string;
+    lastSeenTs: string;
+    unread: boolean;
+    replyUserId?: string;
+    replyUserName?: string;
+    replyTs?: string;
+    replyPreview?: string;
+    permalink?: string;
+}
+interface SlackReplyBadge {
+    id: string;
+    userId: string;
+    userName: string;
+    initials: string;
+    hue: number;
+    permalink: string;
+    label: string;
+    preview?: string;
+    repliedAt: string;
+}
+declare function slackArchiveUrl(channelId: string, ts: string): string;
+declare function recordSlackOutboundWatch(input: {
+    teamId: string;
+    channelId: string;
+    ts: string;
+    threadTs?: string;
+    kind: 'dm' | 'channel';
+    toUserId?: string;
+    toLabel: string;
+    ownerUserId?: string;
+}): SlackOutboundWatch | null;
+declare function listSlackReplyBadges(): SlackReplyBadge[];
+declare function dismissSlackReplyBadge(badgeKey: string): SlackReplyBadge[];
+declare function permalinkForSlackReplyBadge(badgeKey: string): string | null;
+declare function refreshSlackReplyBadges(opts?: {
+    fetchImpl?: typeof fetch;
+    force?: boolean;
+    now?: number;
+}): Promise<SlackReplyBadge[]>;
+
+interface SlackWorkspace {
+    team_id: string;
+    team_name: string;
+    user_id?: string;
+    bot_token?: string;
+    user_token?: string;
+    scopes?: string;
+    connected_at: string;
+}
+/** Safe to send to the renderer / MCP (no tokens). */
+interface SlackWorkspaceInfo {
+    team_id: string;
+    team_name: string;
+    user_id?: string;
+    has_bot_token: boolean;
+    has_user_token: boolean;
+    connected_at: string;
+}
+declare function listSlackWorkspaces(): SlackWorkspaceInfo[];
+declare function getSlackWorkspace(teamId: string): SlackWorkspace | null;
+declare function disconnectSlackWorkspace(teamId: string): SlackWorkspaceInfo[];
+/** Add or update a workspace from a pasted bot (`xoxb-`) or user (`xoxp-`) token. */
+declare function connectSlackToken(rawToken: string): Promise<SlackWorkspaceInfo>;
+
 /** Live status of the Brightsy cloud connect daemon in the desktop app. */
 interface CloudConnectStatus {
     enabled: boolean;
@@ -2864,6 +3121,21 @@ interface CloudConnectStatus {
     lastError: string | null;
     lastLog: string | null;
 }
+/** Live status of Sideboard Slack Listen (hosted relay). */
+interface SlackListenStatus {
+    enabled: boolean;
+    running: boolean;
+    hasAppToken: boolean;
+    /** Built-in Sideboard Slack app Client ID/Secret are present (not sent to renderer). */
+    bakedOAuth: boolean;
+    /** How inbound events arrive when listening. */
+    mode: 'relay' | null;
+    workspaceCount: number;
+    /** This Mac’s Slack destination label (Personal / Work). */
+    deviceLabel: string | null;
+    lastError: string | null;
+    lastLog: string | null;
+}
 /** Shared typed surface for Electron preload ↔ renderer (and docs). */
 interface IpcApi {
     detectAgents(): Promise<AgentStatus[]>;
@@ -2873,14 +3145,14 @@ interface IpcApi {
     installAgent(agent: AgentKind): Promise<AgentSetupActionResult>;
     /** Open the agent’s login/auth command in the system terminal. */
     loginAgent(agent: AgentKind): Promise<AgentSetupActionResult>;
-    getAppSettings(): Promise<AppSettings>;
-    saveAppSettings(settings: AppSettings): Promise<AppSettings>;
-    updateAppEnvironment(patch: Record<string, string | null | undefined>): Promise<AppSettings>;
+    getAppSettings(): Promise<PublicAppSettings>;
+    saveAppSettings(settings: AppSettings): Promise<PublicAppSettings>;
+    updateAppEnvironment(patch: Record<string, string | null | undefined>): Promise<PublicAppSettings>;
     updateClaudeSettings(patch: Partial<ClaudeHarnessSettings> & {
         executablePath?: string | null;
-    }): Promise<AppSettings>;
+    }): Promise<PublicAppSettings>;
     /** Persist a custom executable path for Claude / Codex / OpenCode / Brightsy. */
-    updateAgentExecutable(agent: CliAgentKind, executablePath: string | null): Promise<AppSettings>;
+    updateAgentExecutable(agent: CliAgentKind, executablePath: string | null): Promise<PublicAppSettings>;
     /** Native file picker for a Claude Code executable override. */
     pickClaudeExecutable(): Promise<string | null>;
     /** Native file picker for a CLI agent executable override. */
@@ -2926,20 +3198,46 @@ interface IpcApi {
     }): Promise<CloudConnectStatus>;
     updateBrightsySettings(patch: Partial<BrightsyHarnessSettings> & {
         cloudConnectAgent?: BrightsyCloudConnectAgent | null;
-    }): Promise<AppSettings>;
-    updateAdvancedSettings(patch: Partial<AdvancedAppSettings>): Promise<AppSettings>;
+    }): Promise<PublicAppSettings>;
+    updateAdvancedSettings(patch: Partial<AdvancedAppSettings>): Promise<PublicAppSettings>;
     updateIntegrationsSettings(patch: {
         linearApiKey?: string | null;
         issueSource?: IssueSource | null;
-    }): Promise<AppSettings>;
+        slackClientId?: string | null;
+        slackClientSecret?: string | null;
+        slackAppToken?: string | null;
+        slackListenEnabled?: boolean | null;
+        slackDeviceId?: string | null;
+        slackDeviceLabel?: string | null;
+    }): Promise<PublicAppSettings>;
     updateDefaultsSettings(patch: {
         agent?: AgentKind | null;
         model?: string | null;
         effort?: ThinkingEffort | 'normal' | null;
         fast?: boolean | null;
-    }): Promise<AppSettings>;
+    }): Promise<PublicAppSettings>;
     /** Machine-global GitHub status via `gh`. */
     getGitHubStatus(): Promise<GitHubStatus>;
+    /** Connected Slack workspaces (no tokens). */
+    getSlackWorkspaces(): Promise<SlackWorkspaceInfo[]>;
+    /** Add a workspace from a pasted bot (xoxb-) or user (xoxp-) token. */
+    connectSlackToken(token: string): Promise<SlackWorkspaceInfo[]>;
+    /** Browser OAuth — opens Slack, waits for localhost callback. */
+    startSlackOAuth(): Promise<SlackWorkspaceInfo[]>;
+    disconnectSlackWorkspace(teamId: string): Promise<SlackWorkspaceInfo[]>;
+    /** Browser OAuth — opens Linear, waits for localhost callback. */
+    startLinearOAuth(): Promise<PublicAppSettings>;
+    /** Revoke Linear OAuth (best-effort) and clear stored Linear credentials. */
+    disconnectLinear(): Promise<PublicAppSettings>;
+    /** Sideboard Slack listen (DMs + @mentions → Global orchestrator). */
+    getSlackListenStatus(): Promise<SlackListenStatus>;
+    setSlackListen(opts: {
+        enabled: boolean;
+    }): Promise<SlackListenStatus>;
+    /** Unread Slack replies to messages this Mac posted (does not drive the Mac). */
+    getSlackReplyBadges(): Promise<SlackReplyBadge[]>;
+    /** Open the Slack thread in the browser/app and clear that user's badge. */
+    openSlackReply(badgeId: string): Promise<SlackReplyBadge[]>;
     /**
      * Unified issues for Create-from / Link issue (Linear API or GitHub Issues,
      * based on Account preference with Linear→GitHub fallback).
@@ -3026,6 +3324,11 @@ interface IpcApi {
     getDiff(threadRef: string, opts?: {
         scope?: DiffScope;
         commitSha?: string | null;
+        base?: string;
+        includePatches?: boolean;
+        includeMeta?: boolean;
+        includeUntracked?: boolean;
+        path?: string;
     }): Promise<DiffResult>;
     /** `git init` in the thread worktree when Changes has no Git repo (Cursor-style). */
     initializeGit(threadRef: string): Promise<void>;
@@ -3456,4 +3759,249 @@ 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 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, conductorBundledBinDir, 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, isConductorBundledCli, 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 };
+/** Public WebSocket URL for the hosted Slack inbound relay (path included). */
+declare const BAKED_SLACK_RELAY_URL = "wss://slack-relay.sideboard.cloud/desktop";
+declare function hasBakedSlackOAuth(): boolean;
+/**
+ * Relay URL for inbound Slack when this Mac has no local xapp-.
+ * Override with SIDEBOARD_SLACK_RELAY_URL for local relay testing.
+ */
+declare function slackRelayUrl(): string;
+
+/** Fixed port so the Slack app redirect URI can be registered once. */
+declare const SLACK_OAUTH_PORT = 19847;
+declare const SLACK_OAUTH_REDIRECT = "http://127.0.0.1:19847/callback";
+declare function slackOAuthCredentials(): {
+    clientId: string;
+    clientSecret: string;
+};
+/**
+ * Open Slack OAuth in the browser, listen on a localhost callback, store tokens.
+ */
+declare function startSlackOAuth(opts?: {
+    openUrl?: (url: string) => void | Promise<void>;
+    timeoutMs?: number;
+}): Promise<SlackWorkspaceInfo>;
+
+/** Minimal WebSocket surface so tests can inject a fake without DOM lib types. */
+interface SlackWebSocket {
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: 'open' | 'message' | 'error' | 'close', listener: (ev: {
+        data?: unknown;
+    }) => void): void;
+}
+type SlackWebSocketCtor = new (url: string) => SlackWebSocket;
+interface SlackInboundMessage {
+    teamId: string;
+    channelId: string;
+    ts: string;
+    threadTs?: string;
+    userId?: string;
+    text: string;
+    kind: 'dm' | 'mention';
+}
+interface SlackSocketModeOptions {
+    appToken: string;
+    signal?: AbortSignal;
+    onLog?: (line: string) => void;
+    onEvent: (msg: SlackInboundMessage) => void | Promise<void>;
+    fetchImpl?: typeof fetch;
+    WebSocketImpl?: SlackWebSocketCtor;
+}
+
+declare const SLACK_LISTEN_BUSY_REPLY: string;
+declare const SLACK_LISTEN_STOPPED_REPLY = "Sideboard stopped the in-progress turn. Send another message when you want to continue.";
+declare const SLACK_LISTEN_TIMEOUT_REPLY: string;
+interface SlackListenOptions {
+    agent?: AgentKind;
+    signal?: AbortSignal;
+    onLog?: (line: string) => void;
+    /** Override hosted relay URL (tests / local relay). */
+    relayUrl?: string;
+    fetchImpl?: typeof fetch;
+    WebSocketImpl?: SlackSocketModeOptions['WebSocketImpl'];
+    /** Tests: handle without talking to Slack Web API. */
+    postReply?: (msg: SlackInboundMessage, text: string) => Promise<void>;
+    /** Tests: ack reactions without talking to Slack Web API. */
+    addReaction?: (msg: SlackInboundMessage, name: string) => Promise<void>;
+}
+declare function formatSlackInboundPrompt(msg: SlackInboundMessage): string;
+/**
+ * Prefix Slack replies with This Mac's destination (`Work: …`) so a user with
+ * more than one device can see who answered and address follow-ups the same way.
+ */
+declare function formatSlackSignedReply(deviceLabel: string, text: string): string;
+/** Slack emoji short name for “seen / got it”. */
+declare const SLACK_SEEN_REACTION = "+1";
+/** Thumbs-up the inbound message so Slack shows the bot saw it. */
+declare function ackSlackInboundSeen(msg: SlackInboundMessage, opts: Pick<SlackListenOptions, 'addReaction' | 'fetchImpl' | 'onLog'>): Promise<void>;
+declare function handleSlackInbound(msg: SlackInboundMessage, opts: SlackListenOptions): Promise<void>;
+/**
+ * Only handle Slack events for Slack users who connected this Sideboard
+ * (OAuth authed_user). Other people messaging the bot must run their own Mac.
+ */
+declare function isInboundForThisDesktop(msg: SlackInboundMessage): boolean;
+/**
+ * Sideboard-native Slack inbound via the hosted relay.
+ * The Mac never holds an app-level `xapp-` token.
+ */
+declare function runSlackListen(opts?: SlackListenOptions): Promise<void>;
+/** How Listen will receive Slack events on this machine. */
+declare function resolveSlackListenMode(opts?: {
+    relayUrl?: string | null;
+    workspaceCount?: number;
+}): 'relay' | null;
+
+interface SlackAuthTest {
+    ok: boolean;
+    url?: string;
+    team?: string;
+    user?: string;
+    team_id?: string;
+    user_id?: string;
+    bot_id?: string;
+}
+
+/** Desktop → relay */
+type SlackRelayClientMessage = {
+    type: 'register';
+    teamId: string;
+    /** Slack user who owns this Sideboard (from OAuth authed_user). */
+    userId: string;
+    /** Stable per-Mac id so Personal and Work can both stay connected. */
+    deviceId: string;
+    /** Human label, e.g. "Personal" / "Work". */
+    deviceLabel?: string;
+    botToken: string;
+    /** User token proves identity (auth.test user_id must match). */
+    userToken: string;
+} | {
+    type: 'claim';
+    eventId: string;
+} | {
+    type: 'ping';
+};
+/** Relay → desktop */
+type SlackRelayServerMessage = {
+    type: 'registered';
+    teamId: string;
+    userId: string;
+    deviceId: string;
+} | {
+    type: 'event';
+    eventId: string;
+    message: SlackInboundMessage;
+} | {
+    type: 'claim_ok';
+    eventId: string;
+} | {
+    type: 'claim_denied';
+    eventId: string;
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'pong';
+};
+declare function parseSlackRelayClientMessage(raw: string): SlackRelayClientMessage | null;
+declare function parseSlackRelayServerMessage(raw: string): SlackRelayServerMessage | null;
+
+interface SlackRelaySocket {
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+}
+interface SlackRelaySession {
+    id: string;
+    teamId: string;
+    userId: string;
+    deviceId: string;
+    deviceLabel: string;
+    socket: SlackRelaySocket;
+    connectedAt: number;
+}
+interface SlackRelayHubOptions {
+    fetchImpl?: typeof fetch;
+    /** Inject auth.test for tests. */
+    authTest?: (token: string) => Promise<Pick<SlackAuthTest, 'team_id' | 'user_id' | 'ok'>>;
+    onLog?: (line: string) => void;
+}
+/**
+ * In-memory registry of desktop sessions keyed by team + Slack user + device.
+ * Personal and Work Macs can both stay online. Inbound events fan out to the
+ * matching destination(s); the first device to claim handles the turn.
+ */
+declare class SlackRelayHub {
+    private readonly sessions;
+    private readonly bySocket;
+    private readonly pendingClaims;
+    private seq;
+    private readonly fetchImpl?;
+    private readonly authTest;
+    private readonly log;
+    constructor(opts?: SlackRelayHubOptions);
+    sessionFor(teamId: string, userId: string, deviceId: string): SlackRelaySession | null;
+    sessionsForUser(teamId: string, userId: string): SlackRelaySession[];
+    listSessions(): SlackRelaySession[];
+    detachSocket(socket: SlackRelaySocket): void;
+    handleClientMessage(socket: SlackRelaySocket, msg: SlackRelayClientMessage): Promise<void>;
+    register(socket: SlackRelaySocket, teamId: string, userId: string, deviceId: string, deviceLabel: string | undefined, botToken: string, userToken: string): Promise<void>;
+    /**
+     * Fan-out an inbound event to matching device(s) for that Slack user.
+     * Optional leading `Personal:` / `Work:` selects by device label.
+     * Desktops must claim; first claim wins.
+     */
+    routeEvent(message: SlackInboundMessage): boolean;
+    private handleClaim;
+    private send;
+}
+
+interface SlackRelayServerOptions {
+    appToken: string;
+    port?: number;
+    host?: string;
+    signal?: AbortSignal;
+    onLog?: (line: string) => void;
+    fetchImpl?: typeof fetch;
+    /** Injected hub (tests). */
+    hub?: SlackRelayHub;
+}
+interface SlackRelayServerHandle {
+    port: number;
+    url: string;
+    hub: SlackRelayHub;
+    close: () => Promise<void>;
+}
+/**
+ * Hosted Slack inbound relay: one Socket Mode connection (xapp- on the server)
+ * plus desktop WebSocket sessions that register via bot-token auth.test.
+ */
+declare function startSlackRelayServer(opts: SlackRelayServerOptions): Promise<SlackRelayServerHandle>;
+
+interface SlackRelayRegisterWorkspace {
+    teamId: string;
+    /** Slack user who owns this Sideboard (OAuth authed_user). */
+    userId: string;
+    botToken: string;
+    userToken: string;
+}
+interface SlackRelayClientOptions {
+    /** Full WebSocket URL including path, e.g. wss://slack-relay.sideboard.cloud/desktop */
+    url: string;
+    workspaces: SlackRelayRegisterWorkspace[];
+    /** Stable per-Mac destination id. */
+    deviceId: string;
+    /** Human label shown in relay logs, e.g. Personal / Work. */
+    deviceLabel?: string;
+    signal?: AbortSignal;
+    onEvent: (msg: SlackInboundMessage) => void | Promise<void>;
+    onLog?: (line: string) => void;
+    WebSocketImpl?: SlackWebSocketCtor;
+}
+/**
+ * Desktop client: connect to the hosted Slack relay, register this Mac as a
+ * destination for the OAuth Slack user, claim inbound events before handling.
+ */
+declare function runSlackRelayClient(opts: SlackRelayClientOptions): Promise<void>;
+
+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, BAKED_SLACK_RELAY_URL, 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 CaffeinateHoldState, 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, LINEAR_OAUTH_PORT, LINEAR_OAUTH_REDIRECT, LINEAR_OAUTH_SCOPES, 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, type PublicAppSettings, type PublicIntegrationsSettings, 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, SLACK_LISTEN_BUSY_REPLY, SLACK_LISTEN_STOPPED_REPLY, SLACK_LISTEN_TIMEOUT_REPLY, SLACK_OAUTH_PORT, SLACK_OAUTH_REDIRECT, SLACK_REPLY_FORMATTING, SLACK_SEEN_REACTION, type ScriptHandle, type SideboardMcpProfile, type SkillInfo, type SlackInboundMessage, type SlackListenOptions, type SlackListenStatus, type SlackOutboundWatch, type SlackRelayClientMessage, type SlackRelayClientOptions, SlackRelayHub, type SlackRelayServerHandle, type SlackRelayServerMessage, type SlackRelayServerOptions, type SlackReplyBadge, type SlackWorkspaceInfo, 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, ackSlackInboundSeen, 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, caffeinateHoldPath, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, caffeinateWhileSlackListenEnabled, captureLoginEnv, captureTurnBaseline, checkoutPrStackLayer, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, coerceOrchestratorAgent, collectTakenTeamSlugs, commitAll, conductorBundledBinDir, conductorDbPath, confirmLand, connectBrightsyTeam, connectSlackToken, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createExistingBranchWorktree, createGlobalChat, createLinearPkce, createOrUpdatePr, createPrStack, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectGhStack, detectLocalMergeConflicts, disconnectBrightsyTeam, disconnectLinear, disconnectLinearConnection, disconnectSlackWorkspace, discoverSkills, dismissSlackReplyBadge, dropCachedPrefixOnResume, encodeBrightsyTarget, enrichPathWithNpmGlobalBin, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureReviewRequestFile, ensureSlackCoordinator, ensureSlackDeviceIdentity, 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, formatSlackInboundPrompt, formatSlackSignedReply, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, formatWorktreeReminder, getAdapter, getAgentSetupInfo, getBrightsySession, getCaffeinateHold, getDefaultAgent, getDefaultEffort, getDefaultFast, getDefaultModel, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getLinearAuthToken, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getPrStack, getRepoSetupInfo, getRunMode, getRunScript, getSlackWorkspace, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, handleSlackInbound, harnessEnvKey, hasBakedLinearOAuth, hasBakedSlackOAuth, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initPrStack, initStackFromThread, initializeGitRepository, inspectGitWorktree, installAgent, isAskUserToolName, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isConductorBundledCli, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isInPrStack, isInboundForThisDesktop, isLinearConnected, isOrchestratorCapableAgent, isOrchestratorThread, isPidAlive, isPlaceholderBranch, isPresentPlanToolName, isSessionQuotaLimit, isSideboardScratchPath, isSlackCoordinatorThread, isThinkingEffort, isWorkspaceScratchPath, linearAuthorizationHeader, linearOAuthAuthorizeUrl, linearOAuthCredentials, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listModelsForAgent, listOpencodeModels, listPrs, listRunScripts, listSlackReplyBadges, listSlackWorkspaces, 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, parseSlackRelayClientMessage, parseSlackRelayServerMessage, partsToAssistantText, pastedTextStats, permalinkForSlackReplyBadge, permissionMode, persistVaultKeyInKeychain, planFileAbs, posixShellSingleQuote, prepareTerminalCommand, previewLand, promptMentionsBrightsy, pushBranch, readExistingReviewRequestFile, readKeychainVaultKey, readPlanFile, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, recordSlackOutboundWatch, refreshGitHubAuth, refreshSlackReplyBadges, removeWorkspace, removeWorktree, repoSlug, requestReview, requireAgent, resetGhStackDetectCache, resolveAgentExecutable, resolveClaudeExecutable, resolveCommandBinarySync, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGhAuthToken, resolveGithubRepoSlug, resolveLoginCommand, resolveNewThreadOptions, resolvePlanMarkdown, resolvePrSelector, resolveQuotaFallbackAgent, resolveRepoRoot, resolveReviewGuidelines, resolveSlackListenMode, resolveThreadDefaults, resolveThreadEffort, resolveVaultKey, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, runSlackListen, runSlackRelayClient, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, saveLinearOAuth, secureFileUnlocksWith, setCaffeinateHold, setStatus, setVaultMasterKey, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, shouldInjectBrightsyMcp, shouldRefreshReviewRequestTemplate, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardMcpProfile, sideboardReposDir, sideboardWorkspacesDir, slackAppLevelToken, slackArchiveUrl, slackCoordinatorSourceRef, slackListenEnabled, slackOAuthCredentials, slackRelayUrl, slugify, spawnAgentTurn, splitForCompaction, stackAgentDefaultsFrom, stackIdFrom, stackMergeReadiness, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startLinearOAuth, startMcpServer, startOrchestration, startSlackOAuth, startSlackRelayServer, stripBrightsyNdjsonNoise, submitPrStack, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, thinkingEffortBars, thinkingEffortLabel, threadDisplayLabel, threadFilePath, threadLockPath, threadRequestsBrightsyMcp, threadsDir, threadsSharingWorktree, toPublicAppSettings, 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 };