@sideboard-ai/core 0.1.24 → 0.1.31

package/dist/index.d.cts

@@ -51,6 +51,10 @@ interface ThreadAttachment {
     name: string;
     kind: 'transcript' | 'file' | 'issue' | 'workspace' | 'diff-comment';
     content: string;
+    /** Worktree-relative path when this attachment is a real file that can be opened in a tab. */
+    path?: string;
+    /** data: URL thumbnail for image attachments shown in the composer (pending only). */
+    previewDataUrl?: string;
 }
 interface Thread {
     id: string;
@@ -93,6 +97,8 @@ interface CreateChatTabInput {
     /** Existing thread in the worktree to clone workspace metadata from. */
     fromThreadId: string;
     agent?: AgentKind;
+    model?: string | null;
+    autonomy?: Autonomy;
     title?: string;
     attachments?: ThreadAttachment[];
 }
@@ -1076,6 +1082,20 @@ declare const brightsyAdapter: AgentAdapter;
 
 declare const claudeAdapter: AgentAdapter;
 
+/** Shared shape for composer agent model pickers. */
+type AgentModelInfo = {
+    id: string;
+    displayName: string;
+    description?: string;
+};
+/** @deprecated Prefer {@link AgentModelInfo} — same shape. */
+type CursorModelInfo = AgentModelInfo;
+
+/**
+ * Models from `codex debug models` (JSON catalog). Prefers visibility=list.
+ * Falls back to a small static list when Codex isn't installed / command fails.
+ */
+declare function listCodexModels(): Promise<AgentModelInfo[]>;
 declare const codexAdapter: AgentAdapter;
 
 /** JSON payload written to the Cursor runner on stdin. */
@@ -1123,8 +1143,23 @@ declare function cursorSdkMessageToEvents(msg: CursorSdkStreamMessage): AgentEve
 /** Parse one NDJSON line emitted by the Cursor runner (already Sideboard AgentEvents). */
 declare function parseCursorRunnerLine(line: string): AgentEvent | AgentEvent[] | null;
 
+/** True when the thread uses Cursor Auto (`default` / null / `auto`). */
+declare function isCursorAutoModel(model: string | null | undefined): boolean;
+/** Resolve SDK model id for a turn (null → Auto). */
+declare function resolveCursorModelId(model: string | null | undefined): string;
+/**
+ * List models available to the configured CURSOR_API_KEY.
+ * Cached briefly; falls back to a small static list when unauthenticated / offline.
+ */
+declare function listCursorModels(): Promise<AgentModelInfo[]>;
+
 declare const cursorAdapter: AgentAdapter;
 
+/**
+ * Models from `opencode models` (`provider/model` lines).
+ * Falls back to a small static list when OpenCode isn't installed.
+ */
+declare function listOpencodeModels(): Promise<AgentModelInfo[]>;
 declare const opencodeAdapter: AgentAdapter;
 
 /**
@@ -1134,6 +1169,42 @@ declare const opencodeAdapter: AgentAdapter;
  */
 declare function ensureAgentPath(env?: NodeJS.ProcessEnv): string;
 
+type AgentSetupKind = 'cli' | 'api-key' | 'bundled-sdk';
+interface AgentSetupInfo {
+    agent: AgentKind;
+    kind: AgentSetupKind;
+    /** Short explanation for Settings. */
+    summary: string;
+    docsUrl: string;
+    /** Shell one-liner to install the CLI (null when not applicable). */
+    installCommand: string | null;
+    /** Shell one-liner for interactive login/auth (null when API-key only). */
+    loginCommand: string | null;
+    /** npm package for in-app `npm i -g` when install is npm-based. */
+    npmPackage?: string;
+}
+interface AgentSetupActionResult {
+    ok: boolean;
+    /** True when a system Terminal window was opened for an interactive command. */
+    openedTerminal?: boolean;
+    command?: string;
+    message: string;
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number | null;
+}
+declare function getAgentSetupInfo(agent: AgentKind): AgentSetupInfo;
+declare function listAgentSetupInfo(): AgentSetupInfo[];
+/**
+ * Open an interactive shell command in the system terminal (macOS Terminal.app,
+ * Linux gnome-terminal/x-terminal-emulator, Windows cmd).
+ */
+declare function openInSystemTerminal(command: string): Promise<void>;
+/** Install a CLI agent: npm packages run in-process; curl installers open Terminal. */
+declare function installAgent(agent: AgentKind): Promise<AgentSetupActionResult>;
+/** Open the agent’s login/auth command in the system terminal. */
+declare function loginAgent(agent: AgentKind): Promise<AgentSetupActionResult>;
+
 declare function getAdapter(kind: AgentKind): AgentAdapter;
 declare function allAdapters(): AgentAdapter[];
 
@@ -1513,6 +1584,35 @@ interface DiffCommentInput {
  */
 declare function buildDiffCommentAttachment(input: DiffCommentInput): ThreadAttachment;
 
+declare function isImageFilePath(filePath: string): boolean;
+/**
+ * Build a composer attachment from an absolute filesystem path (no copy).
+ * Used by the native file picker when no worktree is available yet.
+ */
+declare function attachmentFromAbsolutePath(absolutePath: string): ThreadAttachment;
+/**
+ * Copy absolute paths into `.sideboard/attachments/` and return composer attachments
+ * with worktree-relative `path` (and image previews when applicable).
+ */
+declare function stageAbsolutePathsAsAttachments(worktreePath: string, absolutePaths: string[]): ThreadAttachment[];
+interface ComposerFileBuffer {
+    name: string;
+    dataBase64: string;
+}
+/**
+ * Write in-memory file buffers into `.sideboard/attachments/` (renderer drop
+ * fallback when Electron does not expose a filesystem path).
+ */
+declare function stageBuffersAsAttachments(worktreePath: string, buffers: ComposerFileBuffer[]): ThreadAttachment[];
+/**
+ * Build attachments from in-memory buffers without a worktree (create modal).
+ */
+declare function attachmentsFromBuffers(buffers: ComposerFileBuffer[]): ThreadAttachment[];
+/**
+ * Attach existing worktree-relative files (e.g. drag from the file tree).
+ */
+declare function attachmentsFromWorktreePaths(worktreePath: string, relativePaths: string[]): ThreadAttachment[];
+
 interface SummarizeResult {
     summary: string;
     method: 'claude' | 'extractive';
@@ -1832,6 +1932,15 @@ declare class Orchestrator {
     }): Promise<Thread>;
     renameThread(threadRef: string, title: string): Thread;
     setAttachments(threadRef: string, attachments: Thread['attachments']): Thread;
+    /**
+     * Stage OS / worktree files into composer attachments (copies external files
+     * into `.sideboard/attachments/` so agents can Read images and binaries).
+     */
+    attachComposerFiles(threadRef: string, opts: {
+        absolutePaths?: string[];
+        relativePaths?: string[];
+        buffers?: ComposerFileBuffer[];
+    }): ThreadAttachment[];
     listWorktreeChats(threadRef: string): Thread[];
     archive(threadRef: string): Promise<Thread>;
     purge(threadRef: string, opts?: {
@@ -1964,6 +2073,12 @@ interface CloudConnectStatus {
 /** Shared typed surface for Electron preload ↔ renderer (and docs). */
 interface IpcApi {
     detectAgents(): Promise<AgentStatus[]>;
+    /** Install recipe + docs for Settings → Agents. */
+    getAgentSetupInfo(agent: AgentKind): Promise<AgentSetupInfo>;
+    /** Install a CLI agent (npm in-process or Terminal for curl installers). */
+    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>;
@@ -1977,6 +2092,12 @@ interface IpcApi {
     /** Ensure `~/.claude/settings.json` exists and open it in the OS default app. */
     openClaudeUserSettings(): Promise<void>;
     listBrightsyChatTargets(): Promise<BrightsyChatTargets>;
+    /** Models from `Cursor.models.list` for the composer picker. */
+    listCursorModels(): Promise<CursorModelInfo[]>;
+    /** Models from `codex debug models` for the composer picker. */
+    listCodexModels(): Promise<AgentModelInfo[]>;
+    /** Models from `opencode models` for the composer picker. */
+    listOpencodeModels(): Promise<AgentModelInfo[]>;
     /** Brightsy login + connected teams (shared by CLI, Brightsy agent, and Claude MCP). */
     getBrightsySession(): Promise<BrightsySession>;
     /**
@@ -2035,6 +2156,24 @@ interface IpcApi {
     forkThreadWorktree(input: ForkThreadWorktreeInput): Promise<Thread>;
     renameThread(threadRef: string, title: string): Promise<Thread>;
     setAttachments(threadRef: string, attachments: ThreadAttachment[]): Promise<Thread>;
+    /**
+     * Stage dropped/picked files into composer attachments. External files are
+     * copied into `.sideboard/attachments/` in the thread worktree.
+     */
+    attachComposerFiles(threadRef: string, opts: {
+        absolutePaths?: string[];
+        relativePaths?: string[];
+        /** When Electron hides File.path, renderer sends file bytes instead. */
+        buffers?: Array<{
+            name: string;
+            dataBase64: string;
+        }>;
+    }): Promise<ThreadAttachment[]>;
+    /**
+     * Resolve an absolute filesystem path for a File from a drag/drop or picker.
+     * Uses Electron `webUtils.getPathForFile` (File.path is unavailable under contextIsolation).
+     */
+    getPathForFile(file: File): string;
     listWorktreeChats(threadRef: string): Promise<Thread[]>;
     listWorkspaces(): Promise<Workspace[]>;
     addWorkspace(repoPath: string): Promise<Workspace>;
@@ -2216,8 +2355,18 @@ interface IpcApi {
     getRepoPath(): Promise<string>;
     setRepoPath(path: string): Promise<string>;
     pickRepoPath(): Promise<string | null>;
-    /** Native file picker; returns attachments ready for the composer. */
-    pickFiles(): Promise<ThreadAttachment[]>;
+    /**
+     * Native file picker; returns attachments ready for the composer.
+     * When `threadRef` is set, files are staged into the worktree (same as drop).
+     */
+    pickFiles(threadRef?: string | null): Promise<ThreadAttachment[]>;
+    /** Build composer attachments from absolute paths without a worktree (create modal). */
+    attachmentsFromPaths(absolutePaths: string[]): Promise<ThreadAttachment[]>;
+    /** Build composer attachments from in-memory file buffers (create modal drop fallback). */
+    attachmentsFromBuffers(buffers: Array<{
+        name: string;
+        dataBase64: string;
+    }>): Promise<ThreadAttachment[]>;
     /** Prefer worktree settings; optional main-repo fallback. */
     hasConductorHook(worktreePath: string, repoPath?: string | null): Promise<boolean>;
     getRepoSetupInfo(worktreePath: string, repoPath?: string | null): Promise<{
@@ -2433,4 +2582,4 @@ declare function writeInjectedMcpConfig(opts: {
     includeBrightsy?: boolean;
 }): Promise<string | null>;
 
-export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, 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, 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 ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, 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 GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };
+export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, 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, 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 CreateThreadInput, type CreateWorktreeResult, type CursorModelInfo, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, 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 GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getAgentSetupInfo, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, installAgent, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listOpencodeModels, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, loginAgent, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };

package/dist/index.d.ts

@@ -51,6 +51,10 @@ interface ThreadAttachment {
     name: string;
     kind: 'transcript' | 'file' | 'issue' | 'workspace' | 'diff-comment';
     content: string;
+    /** Worktree-relative path when this attachment is a real file that can be opened in a tab. */
+    path?: string;
+    /** data: URL thumbnail for image attachments shown in the composer (pending only). */
+    previewDataUrl?: string;
 }
 interface Thread {
     id: string;
@@ -93,6 +97,8 @@ interface CreateChatTabInput {
     /** Existing thread in the worktree to clone workspace metadata from. */
     fromThreadId: string;
     agent?: AgentKind;
+    model?: string | null;
+    autonomy?: Autonomy;
     title?: string;
     attachments?: ThreadAttachment[];
 }
@@ -1076,6 +1082,20 @@ declare const brightsyAdapter: AgentAdapter;
 
 declare const claudeAdapter: AgentAdapter;
 
+/** Shared shape for composer agent model pickers. */
+type AgentModelInfo = {
+    id: string;
+    displayName: string;
+    description?: string;
+};
+/** @deprecated Prefer {@link AgentModelInfo} — same shape. */
+type CursorModelInfo = AgentModelInfo;
+
+/**
+ * Models from `codex debug models` (JSON catalog). Prefers visibility=list.
+ * Falls back to a small static list when Codex isn't installed / command fails.
+ */
+declare function listCodexModels(): Promise<AgentModelInfo[]>;
 declare const codexAdapter: AgentAdapter;
 
 /** JSON payload written to the Cursor runner on stdin. */
@@ -1123,8 +1143,23 @@ declare function cursorSdkMessageToEvents(msg: CursorSdkStreamMessage): AgentEve
 /** Parse one NDJSON line emitted by the Cursor runner (already Sideboard AgentEvents). */
 declare function parseCursorRunnerLine(line: string): AgentEvent | AgentEvent[] | null;
 
+/** True when the thread uses Cursor Auto (`default` / null / `auto`). */
+declare function isCursorAutoModel(model: string | null | undefined): boolean;
+/** Resolve SDK model id for a turn (null → Auto). */
+declare function resolveCursorModelId(model: string | null | undefined): string;
+/**
+ * List models available to the configured CURSOR_API_KEY.
+ * Cached briefly; falls back to a small static list when unauthenticated / offline.
+ */
+declare function listCursorModels(): Promise<AgentModelInfo[]>;
+
 declare const cursorAdapter: AgentAdapter;
 
+/**
+ * Models from `opencode models` (`provider/model` lines).
+ * Falls back to a small static list when OpenCode isn't installed.
+ */
+declare function listOpencodeModels(): Promise<AgentModelInfo[]>;
 declare const opencodeAdapter: AgentAdapter;
 
 /**
@@ -1134,6 +1169,42 @@ declare const opencodeAdapter: AgentAdapter;
  */
 declare function ensureAgentPath(env?: NodeJS.ProcessEnv): string;
 
+type AgentSetupKind = 'cli' | 'api-key' | 'bundled-sdk';
+interface AgentSetupInfo {
+    agent: AgentKind;
+    kind: AgentSetupKind;
+    /** Short explanation for Settings. */
+    summary: string;
+    docsUrl: string;
+    /** Shell one-liner to install the CLI (null when not applicable). */
+    installCommand: string | null;
+    /** Shell one-liner for interactive login/auth (null when API-key only). */
+    loginCommand: string | null;
+    /** npm package for in-app `npm i -g` when install is npm-based. */
+    npmPackage?: string;
+}
+interface AgentSetupActionResult {
+    ok: boolean;
+    /** True when a system Terminal window was opened for an interactive command. */
+    openedTerminal?: boolean;
+    command?: string;
+    message: string;
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number | null;
+}
+declare function getAgentSetupInfo(agent: AgentKind): AgentSetupInfo;
+declare function listAgentSetupInfo(): AgentSetupInfo[];
+/**
+ * Open an interactive shell command in the system terminal (macOS Terminal.app,
+ * Linux gnome-terminal/x-terminal-emulator, Windows cmd).
+ */
+declare function openInSystemTerminal(command: string): Promise<void>;
+/** Install a CLI agent: npm packages run in-process; curl installers open Terminal. */
+declare function installAgent(agent: AgentKind): Promise<AgentSetupActionResult>;
+/** Open the agent’s login/auth command in the system terminal. */
+declare function loginAgent(agent: AgentKind): Promise<AgentSetupActionResult>;
+
 declare function getAdapter(kind: AgentKind): AgentAdapter;
 declare function allAdapters(): AgentAdapter[];
 
@@ -1513,6 +1584,35 @@ interface DiffCommentInput {
  */
 declare function buildDiffCommentAttachment(input: DiffCommentInput): ThreadAttachment;
 
+declare function isImageFilePath(filePath: string): boolean;
+/**
+ * Build a composer attachment from an absolute filesystem path (no copy).
+ * Used by the native file picker when no worktree is available yet.
+ */
+declare function attachmentFromAbsolutePath(absolutePath: string): ThreadAttachment;
+/**
+ * Copy absolute paths into `.sideboard/attachments/` and return composer attachments
+ * with worktree-relative `path` (and image previews when applicable).
+ */
+declare function stageAbsolutePathsAsAttachments(worktreePath: string, absolutePaths: string[]): ThreadAttachment[];
+interface ComposerFileBuffer {
+    name: string;
+    dataBase64: string;
+}
+/**
+ * Write in-memory file buffers into `.sideboard/attachments/` (renderer drop
+ * fallback when Electron does not expose a filesystem path).
+ */
+declare function stageBuffersAsAttachments(worktreePath: string, buffers: ComposerFileBuffer[]): ThreadAttachment[];
+/**
+ * Build attachments from in-memory buffers without a worktree (create modal).
+ */
+declare function attachmentsFromBuffers(buffers: ComposerFileBuffer[]): ThreadAttachment[];
+/**
+ * Attach existing worktree-relative files (e.g. drag from the file tree).
+ */
+declare function attachmentsFromWorktreePaths(worktreePath: string, relativePaths: string[]): ThreadAttachment[];
+
 interface SummarizeResult {
     summary: string;
     method: 'claude' | 'extractive';
@@ -1832,6 +1932,15 @@ declare class Orchestrator {
     }): Promise<Thread>;
     renameThread(threadRef: string, title: string): Thread;
     setAttachments(threadRef: string, attachments: Thread['attachments']): Thread;
+    /**
+     * Stage OS / worktree files into composer attachments (copies external files
+     * into `.sideboard/attachments/` so agents can Read images and binaries).
+     */
+    attachComposerFiles(threadRef: string, opts: {
+        absolutePaths?: string[];
+        relativePaths?: string[];
+        buffers?: ComposerFileBuffer[];
+    }): ThreadAttachment[];
     listWorktreeChats(threadRef: string): Thread[];
     archive(threadRef: string): Promise<Thread>;
     purge(threadRef: string, opts?: {
@@ -1964,6 +2073,12 @@ interface CloudConnectStatus {
 /** Shared typed surface for Electron preload ↔ renderer (and docs). */
 interface IpcApi {
     detectAgents(): Promise<AgentStatus[]>;
+    /** Install recipe + docs for Settings → Agents. */
+    getAgentSetupInfo(agent: AgentKind): Promise<AgentSetupInfo>;
+    /** Install a CLI agent (npm in-process or Terminal for curl installers). */
+    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>;
@@ -1977,6 +2092,12 @@ interface IpcApi {
     /** Ensure `~/.claude/settings.json` exists and open it in the OS default app. */
     openClaudeUserSettings(): Promise<void>;
     listBrightsyChatTargets(): Promise<BrightsyChatTargets>;
+    /** Models from `Cursor.models.list` for the composer picker. */
+    listCursorModels(): Promise<CursorModelInfo[]>;
+    /** Models from `codex debug models` for the composer picker. */
+    listCodexModels(): Promise<AgentModelInfo[]>;
+    /** Models from `opencode models` for the composer picker. */
+    listOpencodeModels(): Promise<AgentModelInfo[]>;
     /** Brightsy login + connected teams (shared by CLI, Brightsy agent, and Claude MCP). */
     getBrightsySession(): Promise<BrightsySession>;
     /**
@@ -2035,6 +2156,24 @@ interface IpcApi {
     forkThreadWorktree(input: ForkThreadWorktreeInput): Promise<Thread>;
     renameThread(threadRef: string, title: string): Promise<Thread>;
     setAttachments(threadRef: string, attachments: ThreadAttachment[]): Promise<Thread>;
+    /**
+     * Stage dropped/picked files into composer attachments. External files are
+     * copied into `.sideboard/attachments/` in the thread worktree.
+     */
+    attachComposerFiles(threadRef: string, opts: {
+        absolutePaths?: string[];
+        relativePaths?: string[];
+        /** When Electron hides File.path, renderer sends file bytes instead. */
+        buffers?: Array<{
+            name: string;
+            dataBase64: string;
+        }>;
+    }): Promise<ThreadAttachment[]>;
+    /**
+     * Resolve an absolute filesystem path for a File from a drag/drop or picker.
+     * Uses Electron `webUtils.getPathForFile` (File.path is unavailable under contextIsolation).
+     */
+    getPathForFile(file: File): string;
     listWorktreeChats(threadRef: string): Promise<Thread[]>;
     listWorkspaces(): Promise<Workspace[]>;
     addWorkspace(repoPath: string): Promise<Workspace>;
@@ -2216,8 +2355,18 @@ interface IpcApi {
     getRepoPath(): Promise<string>;
     setRepoPath(path: string): Promise<string>;
     pickRepoPath(): Promise<string | null>;
-    /** Native file picker; returns attachments ready for the composer. */
-    pickFiles(): Promise<ThreadAttachment[]>;
+    /**
+     * Native file picker; returns attachments ready for the composer.
+     * When `threadRef` is set, files are staged into the worktree (same as drop).
+     */
+    pickFiles(threadRef?: string | null): Promise<ThreadAttachment[]>;
+    /** Build composer attachments from absolute paths without a worktree (create modal). */
+    attachmentsFromPaths(absolutePaths: string[]): Promise<ThreadAttachment[]>;
+    /** Build composer attachments from in-memory file buffers (create modal drop fallback). */
+    attachmentsFromBuffers(buffers: Array<{
+        name: string;
+        dataBase64: string;
+    }>): Promise<ThreadAttachment[]>;
     /** Prefer worktree settings; optional main-repo fallback. */
     hasConductorHook(worktreePath: string, repoPath?: string | null): Promise<boolean>;
     getRepoSetupInfo(worktreePath: string, repoPath?: string | null): Promise<{
@@ -2433,4 +2582,4 @@ declare function writeInjectedMcpConfig(opts: {
     includeBrightsy?: boolean;
 }): Promise<string | null>;
 
-export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, 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, 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 ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, 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 GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };
+export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, 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, 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 CreateThreadInput, type CreateWorktreeResult, type CursorModelInfo, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, 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 GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getAgentSetupInfo, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, installAgent, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listOpencodeModels, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, loginAgent, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };