@sideboard-ai/core 0.1.51 → 0.1.53

package/dist/index.d.cts

@@ -113,6 +113,13 @@ interface Thread {
     prUrl: string | null;
     /** Cached PR title for Conductor-style sidebar labels (PR title > branch). */
     prTitle: string | null;
+    /**
+     * Stable id for a GitHub PR stack this thread belongs to (shared across layer worktrees).
+     * Null when not part of a stack.
+     */
+    stackId: string | null;
+    /** 1-based layer position in the stack (bottom = 1), when {@link stackId} is set. */
+    stackLayer: number | null;
     /** When true, `title` is a manual override and is not overwritten by branch/PR sync. */
     userSetTitle: boolean;
     createdAt: string;
@@ -266,6 +273,39 @@ interface PrMeta {
     baseRefName: string;
     headRefName: string;
 }
+/** One layer in a GitHub PR stack (bottom = position 1). */
+interface PrStackLayer {
+    /** 1-based index from trunk (bottom = 1). */
+    position: number;
+    branchName: string;
+    /** Tip SHA when known from `gh stack view`. */
+    headSha?: string;
+    /** Parent tip SHA last recorded by gh-stack (may lag). */
+    baseSha?: string;
+    isCurrent: boolean;
+    isMerged: boolean;
+    isQueued: boolean;
+    needsRebase: boolean;
+    prNumber: number | null;
+    prUrl: string | null;
+    /** OPEN | MERGED | QUEUED when a PR exists. */
+    prState: string | null;
+    title?: string;
+}
+/** GitHub stacked PRs for a worktree / branch. */
+interface PrStack {
+    /** GitHub stack number when known. */
+    stackNumber: number | null;
+    trunk: string;
+    currentBranch: string;
+    /** Bottom → top. */
+    layers: PrStackLayer[];
+    /** Current layer index in `layers` (0-based), or -1. */
+    currentIndex: number;
+    /** True when every open layer below+including current looks mergeable. */
+    readyToMerge: boolean;
+    blockedReason: string | null;
+}
 interface IssueInfo {
     id: string;
     identifier: string;
@@ -721,7 +761,7 @@ declare function resolveThreadEffort(raw: {
     fast?: unknown;
 }): ThinkingEffort;
 declare function normalizeThread(raw: Thread): Thread;
-declare function createEmptyThread(partial: Omit<Thread, 'id' | 'createdAt' | 'updatedAt' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'userSetTitle' | 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'attachments'> & Partial<Pick<Thread, 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'userSetTitle' | 'attachments'>>): Thread;
+declare function createEmptyThread(partial: Omit<Thread, 'id' | 'createdAt' | 'updatedAt' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'attachments'> & Partial<Pick<Thread, 'sessionId' | 'sourceIsFork' | 'parentThreadId' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode' | 'messages' | 'queue' | 'status' | 'devPort' | 'activeRuns' | 'prUrl' | 'prTitle' | 'stackId' | 'stackLayer' | 'userSetTitle' | 'attachments'>>): Thread;
 declare function withThreadLock<T>(id: string, fn: () => Promise<T>): Promise<T>;
 declare function readThread(id: string): Thread | null;
 declare function writeThread(thread: Thread): void;
@@ -981,6 +1021,15 @@ declare function createThreadWorktree(opts: {
     sourceRef: string;
     slug: string;
 }): Promise<CreateWorktreeResult>;
+/**
+ * Attach a worktree to an **existing** branch (stack layers).
+ * Unlike {@link createThreadWorktree}, does not create `thread/<slug>`.
+ */
+declare function createExistingBranchWorktree(opts: {
+    repoPath: string;
+    branchName: string;
+    slug: string;
+}): Promise<CreateWorktreeResult>;
 declare function removeWorktree(repoPath: string, worktreePath: string, opts?: {
     deleteBranch?: string;
 }): Promise<void>;
@@ -990,15 +1039,16 @@ declare function listWorktrees(repoPath: string): Promise<Array<{
 }>>;
 declare function isDirty(worktreePath: string): Promise<boolean>;
 /**
- * Local Sideboard attachment scratch (review guidelines seed, composer drops).
+ * Local workspace scratch (`.context/attachments`, legacy `.sideboard/attachments`).
  * Must not force the right-sidebar primary action to "Commit & push".
  */
 declare function isSideboardScratchPath(relativePath: string): boolean;
 declare function currentBranch(worktreePath: string): Promise<string>;
 declare function commitAll(worktreePath: string, message: string): Promise<boolean>;
 declare function pushBranch(worktreePath: string, branchName: string): Promise<void>;
-/** Merge an open pull request via `gh pr merge` (squash by default).
- * Draft PRs are marked ready first — GitHub rejects merge while still draft. */
+/** Merge an open pull request.
+ * When the worktree is on a GitHub PR stack, uses `gh stack merge` (atomic through that PR).
+ * Otherwise: draft → ready, then `gh pr merge` (squash by default). */
 declare function mergePr(cwd: string, selector: string, opts?: {
     method?: 'merge' | 'squash' | 'rebase';
 }): Promise<{
@@ -1022,6 +1072,55 @@ declare function collectTakenTeamSlugs(repoPath: string): Set<string>;
 /** Pick an unused soccer team for the worktree directory / branch slug. */
 declare function allocateTeamSlug(repoPath: string): TeamName;
 
+/**
+ * GitHub stacked PRs via `gh stack` (github/gh-stack extension).
+ * Prefer non-interactive flags — see github/gh-stack SKILL.md.
+ */
+
+type GhStackStatus = {
+    available: true;
+} | {
+    available: false;
+    reason: string;
+};
+/** Whether `gh stack` is installed and runnable. */
+declare function detectGhStack(cwd: string): Promise<GhStackStatus>;
+/** Clear detect cache (tests). */
+declare function resetGhStackDetectCache(): void;
+/** Parse `gh stack view --json` stdout into PrStack. */
+declare function parseGhStackViewJson(raw: string): PrStack | null;
+/**
+ * Merge readiness for merging through the current (or given) layer:
+ * every unmerged layer from bottom through that index must be open, not needing rebase.
+ */
+declare function stackMergeReadiness(layers: PrStackLayer[], throughIndex: number): {
+    readyToMerge: boolean;
+    blockedReason: string | null;
+};
+/** Load stack for the current worktree branch, or null if not in a stack. */
+declare function getPrStack(cwd: string): Promise<PrStack | null>;
+/** True when this cwd's current branch is part of a GitHub stack. */
+declare function isInPrStack(cwd: string): Promise<boolean>;
+declare function mergePrStack(cwd: string, opts: {
+    /** PR number (merge through that PR) or stack number. */
+    through: number;
+    method?: 'merge' | 'squash' | 'rebase';
+}): Promise<{
+    stdout: string;
+}>;
+/** Initialize a stack with one or more branch names (bottom → top). */
+declare function initPrStack(cwd: string, branches: string[], opts?: {
+    base?: string;
+}): Promise<void>;
+/** Add a branch on top of the current stack. */
+declare function addPrStackLayer(cwd: string, branchName: string): Promise<void>;
+/** Push branches and create/update PRs (`--auto` avoids title prompts). */
+declare function submitPrStack(cwd: string, opts?: {
+    open?: boolean;
+}): Promise<void>;
+/** Check out a stack layer by PR number, stack number, URL, or branch. */
+declare function checkoutPrStackLayer(cwd: string, target: string | number): Promise<void>;
+
 interface GitHubStatus {
     connected: boolean;
     login: string | null;
@@ -1152,7 +1251,7 @@ interface AgentAdapter {
         labels: string[];
     }>>;
 }
-declare const PLAN_MODE_INSTRUCTION = "Plan mode is active and must remain active until the user turns Plan mode off in the UI (or explicitly asks you to implement). Analyze the codebase, search and read files as needed, and produce or refine a clear implementation plan. Do not modify, create, or delete any files. Do not exit plan mode on your own.";
+declare const PLAN_MODE_INSTRUCTION = "Plan mode is active and must remain active until the user turns Plan mode off in the UI (or Approves / Hands off the plan). Analyze the codebase, search and read files as needed, and produce or refine a clear implementation plan. Do not modify, create, or delete any project files except via Sideboard MCP present_plan (writes .context/attachments/plan.md). When you need a clarifying decision (approach forks, auth choice, scope): (1) first write a short chat message that explains the decision and what each option means (tradeoffs, when to pick it) \u2014 do not leave the user staring at bare labels; (2) then call Sideboard MCP ask_user with the same options, including a description on every option. Sideboard shows questions in the composer and mirrors them in chat. After ask_user, wait for the user's next message with their answers before finalizing the plan. When the plan is ready for approval: (1) call present_plan with the full markdown plan (title + content) so Sideboard saves .context/attachments/plan.md and shows it in chat for Approve / Hand off / Copy; (2) Claude should also call ExitPlanMode after present_plan. Do not skip present_plan \u2014 the plan must be a markdown file, not only chat prose.";
 declare function permissionMode(thread: Pick<Thread, 'autonomy' | 'planMode'>): {
     claude: string;
     opencodePermission: string;
@@ -1772,7 +1871,7 @@ declare function isImageFilePath(filePath: string): boolean;
  */
 declare function attachmentFromAbsolutePath(absolutePath: string): ThreadAttachment;
 /**
- * Copy absolute paths into `.sideboard/attachments/` and return composer attachments
+ * Copy absolute paths into `.context/attachments/` and return composer attachments
  * with worktree-relative `path` (and image previews when applicable).
  */
 declare function stageAbsolutePathsAsAttachments(worktreePath: string, absolutePaths: string[]): ThreadAttachment[];
@@ -1781,7 +1880,7 @@ interface ComposerFileBuffer {
     dataBase64: string;
 }
 /**
- * Write in-memory file buffers into `.sideboard/attachments/` (renderer drop
+ * Write in-memory file buffers into `.context/attachments/` (renderer drop
  * fallback when Electron does not expose a filesystem path).
  */
 declare function stageBuffersAsAttachments(worktreePath: string, buffers: ComposerFileBuffer[]): ThreadAttachment[];
@@ -1896,7 +1995,7 @@ declare function confirmLand(thread: Thread, opts?: {
     web?: boolean;
 }): Promise<LandResult>;
 
-declare function createThread(input: CreateThreadInput, onSetupLine?: (line: string) => void): Promise<Thread>;
+declare function createThread(input: CreateThreadInput, _onSetupLine?: (line: string) => void): Promise<Thread>;
 /** @deprecated Prefer listIssues() from integrations/issues — agent-agnostic. */
 declare function listLinearIssues(agent: AgentKind, repoPath: string): Promise<{
     id: string;
@@ -1923,6 +2022,96 @@ declare function forkChatTab(input: ForkChatTabInput): Thread;
 /** Fork into a new git worktree branched from the source thread's branch. */
 declare function forkThreadWorktree(input: ForkThreadWorktreeInput, onSetupLine?: (line: string) => void): Promise<Thread>;
 
+/**
+ * Materialize one git worktree + Sideboard thread per GitHub stack layer.
+ */
+
+declare function stackIdFrom(stack: PrStack): string | null;
+declare function findThreadForStackLayer(repoPath: string, stackId: string, layer: Pick<PrStackLayer, 'position' | 'branchName'>): Thread | null;
+type OpenStackLayerInput = {
+    repoPath: string;
+    stack: PrStack;
+    layer: PrStackLayer;
+    agent: AgentKind;
+    autonomy?: Autonomy;
+    model?: string | null;
+    effort?: ThinkingEffort;
+    fast?: boolean;
+    planMode?: boolean;
+    parentThreadId?: string | null;
+    /** Prefer this existing worktree when the branch is already checked out. */
+    reuseExistingWorktree?: boolean;
+};
+type OpenStackLayerResult = {
+    thread: Thread;
+    /** True when a new git worktree was created (caller should run setup). */
+    createdWorktree: boolean;
+};
+/** Open (or return) a thread for one stack layer worktree. */
+declare function openStackLayer(input: OpenStackLayerInput, _onSetupLine?: (line: string) => void): Promise<OpenStackLayerResult>;
+type OpenPrStackLayersInput = {
+    /** Any thread already on a stack layer (used for agent defaults + discovery). */
+    threadRef: string;
+    /** When set, only open this 1-based layer; otherwise open all. */
+    layer?: number;
+};
+/** Open worktrees/threads for stack layers discovered from a thread's cwd. */
+declare function openPrStackLayers(input: OpenPrStackLayersInput, onSetupLine?: (line: string) => void): Promise<{
+    stack: PrStack;
+    threads: Thread[];
+    createdThreadIds: string[];
+}>;
+type AddStackLayerInput = {
+    threadRef: string;
+    branchName: string;
+    title?: string;
+};
+/** `gh stack add` then open a worktree+thread for the new top layer. */
+declare function addStackLayerFromThread(input: AddStackLayerInput, onSetupLine?: (line: string) => void): Promise<{
+    stack: PrStack;
+    thread: Thread;
+    createdWorktree: boolean;
+}>;
+type InitStackFromThreadInput = {
+    threadRef: string;
+    /** Extra layers above the current branch (created empty on top). */
+    additionalBranches?: string[];
+    base?: string;
+};
+/**
+ * Initialize a stack from the current thread's branch (bottom),
+ * optionally adding further empty layers, then open worktrees for each.
+ */
+declare function initStackFromThread(input: InitStackFromThreadInput, onSetupLine?: (line: string) => void): Promise<{
+    stack: PrStack;
+    threads: Thread[];
+    createdThreadIds: string[];
+}>;
+type CreateStackInput = {
+    repoPath: string;
+    /** Bottom → top branch names (created or adopted by gh stack init). */
+    branches: string[];
+    base?: string;
+    agent: AgentKind;
+    autonomy?: Autonomy;
+    model?: string | null;
+    effort?: ThinkingEffort;
+    fast?: boolean;
+    planMode?: boolean;
+    title?: string;
+};
+/**
+ * Create a new stack from trunk: init branches, then one worktree+thread per layer.
+ * First layer gets an optional title; others use branch names until PRs exist.
+ */
+declare function createPrStack(input: CreateStackInput, onSetupLine?: (line: string) => void): Promise<{
+    stack: PrStack;
+    threads: Thread[];
+    createdThreadIds: string[];
+}>;
+/** Defaults for opening stack layers from CreateThreadInput-shaped callers. */
+declare function stackAgentDefaultsFrom(input: Pick<CreateThreadInput, 'agent' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode'>): Pick<OpenStackLayerInput, 'agent' | 'autonomy' | 'model' | 'effort' | 'fast' | 'planMode'>;
+
 /**
  * Conductor persists Cursor SDK agent IDs under cursor-sdk-store/<hash>/agents.ndjson
  * (not in sessions.claude_session_id). Prefer the newest durable agent for a cwd.
@@ -2034,6 +2223,9 @@ declare class Orchestrator {
     getThreads(includeArchived?: boolean): Thread[];
     getThread(idOrRef: string): Thread | null;
     createThread(input: CreateThreadInput): Promise<Thread>;
+    private finishCreateThread;
+    /** Run workspace setup after a new worktree is created (no-op if none configured). */
+    private runSetupAfterCreate;
     listWorkspaces(): Workspace[];
     addWorkspace(repoPath: string): Promise<Workspace>;
     removeWorkspace(repoPath: string): void;
@@ -2161,6 +2353,45 @@ declare class Orchestrator {
     private withPrSelector;
     getPrChecks(threadRef: string): Promise<PrCheckRun[] | null>;
     getPrMeta(threadRef: string): Promise<PrMeta | null>;
+    getPrStack(threadRef: string): Promise<PrStack | null>;
+    /** Open worktrees for all (or one) stack layers discovered from a thread. */
+    openPrStackLayers(threadRef: string, opts?: {
+        layer?: number;
+    }): Promise<{
+        stack: PrStack;
+        threads: Thread[];
+    }>;
+    /** Add a branch on top of the thread's stack and open its worktree. */
+    addStackLayer(threadRef: string, branchName: string, opts?: {
+        title?: string;
+    }): Promise<{
+        stack: PrStack;
+        thread: Thread;
+    }>;
+    /** Initialize a stack from the current thread branch (optional extra layers). */
+    initStackFromThread(threadRef: string, opts?: {
+        additionalBranches?: string[];
+        base?: string;
+    }): Promise<{
+        stack: PrStack;
+        threads: Thread[];
+    }>;
+    /** Create a new multi-layer stack with one worktree per layer. */
+    createPrStack(input: {
+        repoPath: string;
+        branches: string[];
+        base?: string;
+        agent: AgentKind;
+        autonomy?: Autonomy;
+        model?: string | null;
+        effort?: ThinkingEffort;
+        fast?: boolean;
+        planMode?: boolean;
+        title?: string;
+    }): Promise<{
+        stack: PrStack;
+        threads: Thread[];
+    }>;
     getPrDetails(threadRef: string): Promise<PrDetails | null>;
     setAutonomy(threadRef: string, autonomy: Autonomy): Thread;
     /**
@@ -2197,7 +2428,7 @@ declare class Orchestrator {
     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).
+     * into `.context/attachments/` so agents can Read images and binaries).
      */
     attachComposerFiles(threadRef: string, opts: {
         absolutePaths?: string[];
@@ -2233,10 +2464,11 @@ declare function startOrchestration(opts: {
 declare const REPO_REVIEW_PATH = ".sideboard/review.md";
 declare const REPO_REVIEW_NAME = "review.md";
 /**
- * Local / Conductor-style scratch guidelines (gitignored under attachments/).
+ * Local scratch guidelines (gitignored under `.context/attachments/`).
  * Used as override when no repo file exists, or as the stock seed target.
  */
-declare const REVIEW_REQUEST_PATH = ".sideboard/attachments/Review request.md";
+declare const REVIEW_REQUEST_PATH = ".context/attachments/Review request.md";
+declare const LEGACY_REVIEW_REQUEST_PATH = ".sideboard/attachments/Review request.md";
 declare const REVIEW_REQUEST_NAME = "Review request.md";
 /** Short chat message — guidelines live in the attached review file. */
 declare const REVIEW_REQUEST_PREFILL = "Review.";
@@ -2255,8 +2487,9 @@ declare function shouldRefreshReviewRequestTemplate(content: string): boolean;
 /**
  * Resolve which review guidelines to attach:
  * 1. `.sideboard/review.md` (committed, per-repo)
- * 2. `.sideboard/attachments/Review request.md` (local override)
- * 3. Seed stock template into the local attachments path (does not write the repo file)
+ * 2. `.context/attachments/Review request.md` (local override)
+ * 3. Legacy `.sideboard/attachments/Review request.md`
+ * 4. Seed stock template into `.context/attachments/` (does not write the repo file)
  */
 declare function resolveReviewGuidelines(worktreePath: string): ResolvedReviewGuidelines;
 /**
@@ -2287,6 +2520,107 @@ type SendFn = (threadRef: string, prompt: string) => Promise<Thread>;
  */
 declare function requestReview(threadRef: string, send: SendFn): Promise<RequestReviewResult>;
 
+/**
+ * Workspace-local scratch (Conductor-style `.context/`), not committed.
+ * Repo-owned Sideboard config stays under `.sideboard/` (settings, review.md).
+ */
+/** Preferred local attachments root (plan, drops, review seed). */
+declare const ATTACHMENTS_DIR = ".context/attachments";
+/** Pre-migration Sideboard scratch root — still read for compatibility. */
+declare const LEGACY_ATTACHMENTS_DIR = ".sideboard/attachments";
+declare function attachmentsGitignoreBody(): string;
+/** True when a git status path is local scratch and should not count as dirty. */
+declare function isWorkspaceScratchPath(relativePath: string): boolean;
+
+/**
+ * Plan-mode clarifying questions (AskUserQuestion / Sideboard ask_user).
+ * Presented in the composer; answers are sent as a normal user message.
+ */
+interface PlanQuestionOption {
+    label: string;
+    description?: string;
+}
+interface PlanQuestion {
+    /** Full question text. */
+    question: string;
+    /** Short chip label (≤12 chars when from Claude). */
+    header?: string;
+    multiSelect?: boolean;
+    options: PlanQuestionOption[];
+}
+interface PendingPlanQuestions {
+    /** Tool call / presentation id (dismiss + dedupe). */
+    id: string;
+    questions: PlanQuestion[];
+    /** Source tool name for debugging. */
+    source: string;
+}
+/** Normalize AskUserQuestion / ask_user tool input into questions. */
+declare function parsePlanQuestionsInput(input: unknown): PlanQuestion[];
+declare function isAskUserToolName(name: string | undefined | null): boolean;
+type ToolPartLike = {
+    type: string;
+    id?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+    status?: string;
+};
+/** Newest ask-user tool part with parseable questions (live or persisted). */
+declare function extractPendingPlanQuestions(parts: ToolPartLike[] | undefined | null): PendingPlanQuestions | null;
+interface PlanQuestionAnswer {
+    questionIndex: number;
+    /** Selected option labels (empty when only Other). */
+    selected: string[];
+    /** Free-text Other response. */
+    other?: string;
+}
+/** Format answers as a concise user message for the agent. */
+declare function formatPlanQuestionAnswers(questions: PlanQuestion[], answers: PlanQuestionAnswer[]): string;
+/** Markdown brief of questions + option meanings for the chat transcript. */
+declare function formatPlanQuestionsForChat(questions: PlanQuestion[]): string;
+
+/**
+ * Pure helpers for plan presentation (safe for renderer bundling).
+ * File I/O lives in plan-file.ts.
+ */
+/** Canonical relative path inside the worktree (shared by forked chat tabs). */
+declare const PLAN_FILE_REL = ".context/attachments/plan.md";
+declare const PLAN_FILE_NAME = "plan.md";
+/** Legacy path from before plans lived under attachments/. */
+declare const LEGACY_PLAN_FILE_REL = ".sideboard/plan.md";
+declare function isPresentPlanToolName(name: string | undefined | null): boolean;
+type PresentedPlan = {
+    title: string;
+    content: string;
+    path: string;
+    source: 'present_plan' | 'exit_plan' | 'text';
+};
+type PlanToolPartLike = {
+    type: string;
+    id?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+};
+/** Newest present_plan tool payload with markdown content. */
+declare function extractPresentedPlan(parts: PlanToolPartLike[] | undefined | null): PresentedPlan | null;
+/** Best plan markdown from tool parts, then file, then agent text fallback. */
+declare function resolvePlanMarkdown(opts: {
+    parts?: PlanToolPartLike[] | null;
+    text?: string | null;
+    fileContent?: string | null;
+}): PresentedPlan | null;
+
+/**
+ * Worktree plan document I/O (plan mode).
+ * Pure presentation helpers: plan-present.ts
+ */
+
+declare function planFileAbs(worktreePath: string): string;
+/** Prefer `.context/attachments/plan.md`; fall back to legacy Sideboard paths. */
+declare function readPlanFile(worktreePath: string): string | null;
+/** Write (or overwrite) the worktree plan markdown. Returns relative path. */
+declare function writePlanFile(worktreePath: string, content: string): string;
+
 type WorkspaceInventoryEntry = Workspace & {
     /** Best-effort GitHub `owner/repo` from remote / gh. */
     githubSlug?: string | null;
@@ -2486,7 +2820,7 @@ interface IpcApi {
     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.
+     * copied into `.context/attachments/` in the thread worktree.
      */
     attachComposerFiles(threadRef: string, opts: {
         absolutePaths?: string[];
@@ -2555,6 +2889,46 @@ interface IpcApi {
     getPrChecks(threadRef: string): Promise<PrCheckRun[] | null>;
     /** Lightweight PR fields for the sidebar pill (cheap GraphQL). */
     getPrMeta(threadRef: string): Promise<PrMeta | null>;
+    /** GitHub PR stack for the thread worktree, or null if not stacked. */
+    getPrStack(threadRef: string): Promise<PrStack | null>;
+    /** Open worktrees/threads for stack layers (all, or one 1-based position). */
+    openPrStackLayers(threadRef: string, opts?: {
+        layer?: number;
+    }): Promise<{
+        stack: PrStack;
+        threads: Thread[];
+    }>;
+    /** Add a branch on top of the thread's stack and open its worktree. */
+    addStackLayer(threadRef: string, branchName: string, opts?: {
+        title?: string;
+    }): Promise<{
+        stack: PrStack;
+        thread: Thread;
+    }>;
+    /** Turn the current thread branch into a stack (optional extra empty layers). */
+    initStackFromThread(threadRef: string, opts?: {
+        additionalBranches?: string[];
+        base?: string;
+    }): Promise<{
+        stack: PrStack;
+        threads: Thread[];
+    }>;
+    /** Create a new stack with one worktree per layer. */
+    createPrStack(input: {
+        repoPath: string;
+        branches: string[];
+        base?: string;
+        agent: AgentKind;
+        autonomy?: Autonomy;
+        model?: string | null;
+        effort?: ThinkingEffort;
+        fast?: boolean;
+        planMode?: boolean;
+        title?: string;
+    }): Promise<{
+        stack: PrStack;
+        threads: Thread[];
+    }>;
     /** PR description / reviews for the Review tab. */
     getPrDetails(threadRef: string): Promise<PrDetails | null>;
     listFiles(threadRef: string): Promise<string[]>;
@@ -2920,4 +3294,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 AgentModelCatalog, type AgentModelInfo, type AgentSetupActionResult, type AgentSetupInfo, type AgentSetupKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLAUDE_MODEL_CATALOG, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ComposerFileBuffer, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type 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 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_AGENT_KINDS, type OrchestrationQuotaOnLimit, Orchestrator, type OrchestratorAgentKind, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PASTE_ATTACH_MIN_CHARS, PASTE_ATTACH_MIN_LINES, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, REPO_REVIEW_NAME, REPO_REVIEW_PATH, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, type ResolvedReviewGuidelines, type ReviewGuidelinesSource, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, THINKING_EFFORTS, type TeamName, type ThinkingEffort, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, assertOrchestratorCapableAgent, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildPastedTextAttachment, buildReviewRequestAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, coerceOrchestratorAgent, 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, ensureReviewRequestFile, 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, getDefaultAgent, getDefaultEffort, getDefaultFast, getDefaultModel, 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, isOrchestratorCapableAgent, isOrchestratorThread, isPidAlive, isPlaceholderBranch, isSessionQuotaLimit, isSideboardScratchPath, isThinkingEffort, 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, mergeUsage, nextPastedTextName, nextThinkingEffort, normalizeParseResult, normalizeThinkingEffort, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, opencodeAdapter, orchestrationQuotaFallbackAgent, orchestrationQuotaOnLimit, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, parseSessionQuotaResetAt, partsToAssistantText, pastedTextStats, permissionMode, previewLand, pushBranch, readExistingReviewRequestFile, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requestReview, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGhAuthToken, resolveGithubRepoSlug, resolvePrSelector, resolveQuotaFallbackAgent, resolveRepoRoot, resolveReviewGuidelines, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, shouldRefreshReviewRequestTemplate, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, thinkingEffortBars, thinkingEffortLabel, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateDefaultsSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };
+export { ATTACHMENTS_DIR, type ActiveRun, type AddStackLayerInput, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentModelCatalog, type AgentModelInfo, type AgentSetupActionResult, type AgentSetupInfo, type AgentSetupKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLAUDE_MODEL_CATALOG, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ComposerFileBuffer, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateStackInput, type CreateThreadInput, type CreateWorktreeResult, type CursorModelInfo, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DefaultsAppSettings, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GhStackStatus, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type InitStackFromThreadInput, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, LEGACY_ATTACHMENTS_DIR, LEGACY_PLAN_FILE_REL, LEGACY_REVIEW_REQUEST_PATH, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, ORCHESTRATOR_AGENT_KINDS, type OpenPrStackLayersInput, type OpenStackLayerInput, type OpenStackLayerResult, type OrchestrationQuotaOnLimit, Orchestrator, type OrchestratorAgentKind, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PASTE_ATTACH_MIN_CHARS, PASTE_ATTACH_MIN_LINES, PLAN_FILE_NAME, PLAN_FILE_REL, PLAN_MODE_INSTRUCTION, type PendingPlanQuestions, type PlanQuestion, type PlanQuestionAnswer, type PlanQuestionOption, type PlanToolPartLike, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type PrStack, type PrStackLayer, type PresentedPlan, REPO_REVIEW_NAME, REPO_REVIEW_PATH, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, type ResolvedReviewGuidelines, type ReviewGuidelinesSource, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, THINKING_EFFORTS, type TeamName, type ThinkingEffort, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type ToolPartLike, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addPrStackLayer, addStackLayerFromThread, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, assertOrchestratorCapableAgent, attachmentFromAbsolutePath, attachmentsFromBuffers, attachmentsFromWorktreePaths, attachmentsGitignoreBody, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildPastedTextAttachment, buildReviewRequestAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, checkoutPrStackLayer, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, coerceOrchestratorAgent, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createExistingBranchWorktree, createGlobalChat, createOrUpdatePr, createPrStack, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectGhStack, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureReviewRequestFile, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractPendingPlanQuestions, extractPresentedPlan, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, findThreadForStackLayer, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatPlanQuestionAnswers, formatPlanQuestionsForChat, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getAgentSetupInfo, getBrightsySession, getDefaultAgent, getDefaultEffort, getDefaultFast, getDefaultModel, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getPrStack, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initPrStack, initStackFromThread, initializeGitRepository, inspectGitWorktree, installAgent, isAskUserToolName, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isCursorAutoModel, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isImageFilePath, isInPrStack, isLinearConnected, isOrchestratorCapableAgent, isOrchestratorThread, isPidAlive, isPlaceholderBranch, isPresentPlanToolName, isSessionQuotaLimit, isSideboardScratchPath, isThinkingEffort, isWorkspaceScratchPath, listAgentSetupInfo, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listCodexModels, listConductorWorkspaces, listConnectedBrightsyTeams, listCursorModels, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listModelsForAgent, listOpencodeModels, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, loginAgent, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergePrStack, mergeUsage, nextPastedTextName, nextThinkingEffort, normalizeParseResult, normalizeThinkingEffort, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, openPrStackLayers, openStackLayer, opencodeAdapter, orchestrationQuotaFallbackAgent, orchestrationQuotaOnLimit, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGhStackViewJson, parseGithubSlugFromRemoteUrl, parseMcpList, parsePlanQuestionsInput, parseSessionQuotaResetAt, partsToAssistantText, pastedTextStats, permissionMode, planFileAbs, previewLand, pushBranch, readExistingReviewRequestFile, readPlanFile, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requestReview, requireAgent, resetGhStackDetectCache, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGhAuthToken, resolveGithubRepoSlug, resolvePlanMarkdown, resolvePrSelector, resolveQuotaFallbackAgent, resolveRepoRoot, resolveReviewGuidelines, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, shouldRefreshReviewRequestTemplate, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, stackAgentDefaultsFrom, stackIdFrom, stackMergeReadiness, stageAbsolutePathsAsAttachments, stageBuffersAsAttachments, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, submitPrStack, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, thinkingEffortBars, thinkingEffortLabel, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateDefaultsSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writePlanFile, writeThread, writeWorktreeFile };