@sideboard-ai/core 0.1.44 → 0.1.46

package/dist/index.d.cts

@@ -121,6 +121,16 @@ interface Thread {
      * Used so other processes (MCP) do not reclaim a live turn as dead.
      */
     agentPid?: number | null;
+    /**
+     * When set, host auto-retries this orchestration chat after a provider
+     * session/usage quota reset (ISO timestamp).
+     */
+    quotaResumeAt?: string | null;
+    /**
+     * Orchestration chat this one was auto-continued from after a session quota
+     * limit (prevents infinite agent-switch cascades).
+     */
+    quotaContinuedFromId?: string | null;
 }
 interface CreateChatTabInput {
     /** Existing thread in the worktree to clone workspace metadata from. */
@@ -140,6 +150,8 @@ interface ForkChatTabInput {
     /** Inclusive message index to fork through; default = all messages. */
     throughIndex?: number;
     agent?: AgentKind;
+    /** Model for the forked chat; omit to inherit or Auto when agent changes. */
+    model?: string | null;
     title?: string;
 }
 /** Fork a thread into a new git worktree (new branch + worktree dir). */
@@ -148,6 +160,8 @@ interface ForkThreadWorktreeInput {
     /** Inclusive message index to seed transcript through; default = all messages. */
     throughIndex?: number;
     agent?: AgentKind;
+    /** Model for the forked chat; omit to inherit or Auto when agent changes. */
+    model?: string | null;
     title?: string;
 }
 interface ThreadOptionsPatch {
@@ -365,6 +379,15 @@ type OrchestratorEvent = {
     threadId: string;
     olderCount: number;
     method: 'claude' | 'extractive';
+} | {
+    type: 'quota_failover';
+    threadId: string;
+    action: 'switch_agent' | 'wait_reset';
+    message: string;
+    /** New orchestration chat when action is switch_agent. */
+    toThreadId?: string;
+    /** When action is wait_reset — ISO resume time. */
+    resumeAt?: string;
 } | {
     type: 'dev_server_started';
     threadId: string;
@@ -541,6 +564,7 @@ interface IntegrationsSettings {
  * Conductor-inspired power-user preferences (Settings → Advanced).
  * Defaults match Conductor where applicable (auto-rename on, others off).
  */
+type OrchestrationQuotaOnLimit = 'switch_agent' | 'wait_reset';
 interface AdvancedAppSettings {
     /**
      * Ask the agent to rename the temporary `thread/<team>` branch on first send.
@@ -580,6 +604,14 @@ interface AdvancedAppSettings {
     worktreeLastCleanupAt?: string;
     /** When true, reconcile auto-removes excess orphan worktrees. */
     autoCleanupOrphans?: boolean;
+    /**
+     * When an orchestration chat hits a provider session/usage limit:
+     * - `switch_agent` (default): continue on {@link AdvancedAppSettings.orchestrationQuotaFallbackAgent} with Auto
+     * - `wait_reset`: schedule auto-retry when the limit message’s reset time arrives
+     */
+    orchestrationQuotaOnLimit?: OrchestrationQuotaOnLimit;
+    /** Agent to continue on after a session limit (default: cursor). Ignored when equal to the limited agent. */
+    orchestrationQuotaFallbackAgent?: AgentKind;
 }
 interface AppSettings {
     /** Environment variables injected into agent / hook processes (and process.env). */
@@ -655,6 +687,10 @@ declare function caffeinateWhileRunningEnabled(settings?: AppSettings): boolean;
 declare function caffeinateWhileCloudConnectEnabled(settings?: AppSettings): boolean;
 declare function deleteBranchOnPurgeEnabled(settings?: AppSettings): boolean;
 declare function autoCleanupOrphansEnabled(settings?: AppSettings): boolean;
+/** Default: switch to another agent (Auto) when orchestration hits a session limit. */
+declare function orchestrationQuotaOnLimit(settings?: AppSettings): OrchestrationQuotaOnLimit;
+/** Default fallback agent for orchestration session-limit continue (cursor). */
+declare function orchestrationQuotaFallbackAgent(settings?: AppSettings): AgentKind;
 declare function maxConcurrentAgents(settings?: AppSettings): number;
 /** Binary name or absolute path used to spawn Claude Code. */
 declare function resolveClaudeExecutable(settings?: AppSettings): string;
@@ -1195,6 +1231,15 @@ type CursorTurnRequest = {
     fast?: boolean;
     planMode?: boolean;
     apiKey?: string;
+    /**
+     * Inline MCP servers for this turn (Sideboard / Brightsy).
+     * Must be passed on create and resume — Cursor does not persist them.
+     */
+    mcpServers?: Record<string, {
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+    }>;
 };
 /** Subset of Cursor SDK stream messages we care about (keeps tests free of the SDK). */
 type CursorSdkStreamMessage = {
@@ -1250,6 +1295,39 @@ declare const cursorAdapter: AgentAdapter;
 declare function listOpencodeModels(): Promise<AgentModelInfo[]>;
 declare const opencodeAdapter: AgentAdapter;
 
+/** Claude Code aliases used by Sideboard (null = Auto / CLI default). */
+declare const CLAUDE_MODEL_CATALOG: AgentModelInfo[];
+type AgentModelCatalog = {
+    agent: AgentKind;
+    /** Omit / null model = Auto (provider default). Cursor uses id `default`. */
+    auto: true;
+    models: AgentModelInfo[];
+    note?: string;
+};
+/** Models available for one agent (or all when agent omitted). */
+declare function listModelsForAgent(agent?: AgentKind): Promise<AgentModelCatalog[]>;
+
+/**
+ * Provider session/usage quota (Claude “session limit”, weekly/opus caps, etc.).
+ * Not context-window overflow and not billing/credits.
+ */
+declare function isSessionQuotaLimit(text: string): boolean;
+/** Best-effort parse of “resets 7:10pm (America/Los_Angeles)” / “resets in 2 hours”. */
+declare function parseSessionQuotaResetAt(text: string, now?: Date): Date | null;
+/** Pick a different orchestrator-capable agent for quota failover. */
+declare function resolveQuotaFallbackAgent(current: AgentKind, preferred?: AgentKind | null): AgentKind;
+
+/**
+ * Agents that Sideboard can inject Sideboard MCP into for fleet orchestration.
+ * Brightsy CLI has no local MCP injection — it cannot be an orchestrator.
+ */
+declare const ORCHESTRATOR_AGENT_KINDS: readonly ["claude", "codex", "opencode", "cursor"];
+type OrchestratorAgentKind = (typeof ORCHESTRATOR_AGENT_KINDS)[number];
+declare function isOrchestratorCapableAgent(agent: AgentKind | null | undefined): agent is OrchestratorAgentKind;
+declare function assertOrchestratorCapableAgent(agent: AgentKind, context?: string): OrchestratorAgentKind;
+/** Prefer a capable agent; fall back to Claude when the choice is unsupported. */
+declare function coerceOrchestratorAgent(agent: AgentKind | null | undefined, fallback?: OrchestratorAgentKind): OrchestratorAgentKind;
+
 /**
  * Electron / GUI apps often inherit a minimal PATH that omits Homebrew and
  * user bin dirs where `claude` / `codex` / `opencode` / `brightsy` live. Call
@@ -1822,7 +1900,9 @@ declare function forkMessageSlice(from: Thread, throughIndex?: number): ThreadMe
 declare function buildForkTranscriptAttachment(baseTitle: string, messages: ThreadMessage[]): ThreadAttachment;
 /** New chat tab in the same worktree (no new git worktree). */
 declare function createChatTab(input: CreateChatTabInput): Thread;
-/** Fork chat into a new tab with transcript attached in the composer. */
+/** Fork chat into a new tab with transcript attached in the composer.
+ * Works for worktree agents and Global orchestration chats (same global home).
+ */
 declare function forkChatTab(input: ForkChatTabInput): Thread;
 
 /** Fork into a new git worktree branched from the source thread's branch. */
@@ -1901,6 +1981,8 @@ declare class Orchestrator {
     private readonly haltDrain;
     /** WIP snapshot SHA at the start of the latest agent turn (per thread). */
     private readonly turnBaselines;
+    /** Timers for orchestration session-quota auto-resume. */
+    private readonly quotaResumeTimers;
     private maxConcurrent;
     private runningCount;
     constructor(opts?: {
@@ -1924,6 +2006,16 @@ declare class Orchestrator {
          */
         reclaimStaleTurns?: boolean;
     }): Promise<void>;
+    private clearQuotaResumeTimer;
+    /** Schedule (or fire) auto-retry after a provider session/usage limit reset. */
+    private scheduleQuotaResume;
+    private schedulePendingQuotaResumes;
+    private resumeAfterQuotaWait;
+    /**
+     * Host-side continue when an orchestration chat hits a provider session/usage
+     * limit (not context size): switch agent (Auto) or wait until reset.
+     */
+    private maybeHandleOrchestrationQuotaFailover;
     getThreads(includeArchived?: boolean): Thread[];
     getThread(idOrRef: string): Thread | null;
     createThread(input: CreateThreadInput): Promise<Thread>;
@@ -2076,12 +2168,14 @@ declare class Orchestrator {
         threadId: string;
         throughIndex?: number;
         agent?: Thread['agent'];
+        model?: string | null;
         title?: string;
     }): Thread;
     forkThreadWorktree(input: {
         threadId: string;
         throughIndex?: number;
         agent?: Thread['agent'];
+        model?: string | null;
         title?: string;
     }): Promise<Thread>;
     renameThread(threadRef: string, title: string): Thread;
@@ -2777,4 +2871,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 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 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, 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, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, 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, 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, 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, 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, isOrchestratorThread, isPidAlive, isPlaceholderBranch, isThinkingEffort, 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, nextPastedTextName, nextThinkingEffort, normalizeParseResult, normalizeThinkingEffort, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, pastedTextStats, permissionMode, previewLand, pushBranch, readExistingReviewRequestFile, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requestReview, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, 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 { 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, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, 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, 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, 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, resolveGithubRepoSlug, resolvePrSelector, resolveQuotaFallbackAgent, resolveRepoRoot, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, 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 };

package/dist/index.d.ts

@@ -121,6 +121,16 @@ interface Thread {
      * Used so other processes (MCP) do not reclaim a live turn as dead.
      */
     agentPid?: number | null;
+    /**
+     * When set, host auto-retries this orchestration chat after a provider
+     * session/usage quota reset (ISO timestamp).
+     */
+    quotaResumeAt?: string | null;
+    /**
+     * Orchestration chat this one was auto-continued from after a session quota
+     * limit (prevents infinite agent-switch cascades).
+     */
+    quotaContinuedFromId?: string | null;
 }
 interface CreateChatTabInput {
     /** Existing thread in the worktree to clone workspace metadata from. */
@@ -140,6 +150,8 @@ interface ForkChatTabInput {
     /** Inclusive message index to fork through; default = all messages. */
     throughIndex?: number;
     agent?: AgentKind;
+    /** Model for the forked chat; omit to inherit or Auto when agent changes. */
+    model?: string | null;
     title?: string;
 }
 /** Fork a thread into a new git worktree (new branch + worktree dir). */
@@ -148,6 +160,8 @@ interface ForkThreadWorktreeInput {
     /** Inclusive message index to seed transcript through; default = all messages. */
     throughIndex?: number;
     agent?: AgentKind;
+    /** Model for the forked chat; omit to inherit or Auto when agent changes. */
+    model?: string | null;
     title?: string;
 }
 interface ThreadOptionsPatch {
@@ -365,6 +379,15 @@ type OrchestratorEvent = {
     threadId: string;
     olderCount: number;
     method: 'claude' | 'extractive';
+} | {
+    type: 'quota_failover';
+    threadId: string;
+    action: 'switch_agent' | 'wait_reset';
+    message: string;
+    /** New orchestration chat when action is switch_agent. */
+    toThreadId?: string;
+    /** When action is wait_reset — ISO resume time. */
+    resumeAt?: string;
 } | {
     type: 'dev_server_started';
     threadId: string;
@@ -541,6 +564,7 @@ interface IntegrationsSettings {
  * Conductor-inspired power-user preferences (Settings → Advanced).
  * Defaults match Conductor where applicable (auto-rename on, others off).
  */
+type OrchestrationQuotaOnLimit = 'switch_agent' | 'wait_reset';
 interface AdvancedAppSettings {
     /**
      * Ask the agent to rename the temporary `thread/<team>` branch on first send.
@@ -580,6 +604,14 @@ interface AdvancedAppSettings {
     worktreeLastCleanupAt?: string;
     /** When true, reconcile auto-removes excess orphan worktrees. */
     autoCleanupOrphans?: boolean;
+    /**
+     * When an orchestration chat hits a provider session/usage limit:
+     * - `switch_agent` (default): continue on {@link AdvancedAppSettings.orchestrationQuotaFallbackAgent} with Auto
+     * - `wait_reset`: schedule auto-retry when the limit message’s reset time arrives
+     */
+    orchestrationQuotaOnLimit?: OrchestrationQuotaOnLimit;
+    /** Agent to continue on after a session limit (default: cursor). Ignored when equal to the limited agent. */
+    orchestrationQuotaFallbackAgent?: AgentKind;
 }
 interface AppSettings {
     /** Environment variables injected into agent / hook processes (and process.env). */
@@ -655,6 +687,10 @@ declare function caffeinateWhileRunningEnabled(settings?: AppSettings): boolean;
 declare function caffeinateWhileCloudConnectEnabled(settings?: AppSettings): boolean;
 declare function deleteBranchOnPurgeEnabled(settings?: AppSettings): boolean;
 declare function autoCleanupOrphansEnabled(settings?: AppSettings): boolean;
+/** Default: switch to another agent (Auto) when orchestration hits a session limit. */
+declare function orchestrationQuotaOnLimit(settings?: AppSettings): OrchestrationQuotaOnLimit;
+/** Default fallback agent for orchestration session-limit continue (cursor). */
+declare function orchestrationQuotaFallbackAgent(settings?: AppSettings): AgentKind;
 declare function maxConcurrentAgents(settings?: AppSettings): number;
 /** Binary name or absolute path used to spawn Claude Code. */
 declare function resolveClaudeExecutable(settings?: AppSettings): string;
@@ -1195,6 +1231,15 @@ type CursorTurnRequest = {
     fast?: boolean;
     planMode?: boolean;
     apiKey?: string;
+    /**
+     * Inline MCP servers for this turn (Sideboard / Brightsy).
+     * Must be passed on create and resume — Cursor does not persist them.
+     */
+    mcpServers?: Record<string, {
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+    }>;
 };
 /** Subset of Cursor SDK stream messages we care about (keeps tests free of the SDK). */
 type CursorSdkStreamMessage = {
@@ -1250,6 +1295,39 @@ declare const cursorAdapter: AgentAdapter;
 declare function listOpencodeModels(): Promise<AgentModelInfo[]>;
 declare const opencodeAdapter: AgentAdapter;
 
+/** Claude Code aliases used by Sideboard (null = Auto / CLI default). */
+declare const CLAUDE_MODEL_CATALOG: AgentModelInfo[];
+type AgentModelCatalog = {
+    agent: AgentKind;
+    /** Omit / null model = Auto (provider default). Cursor uses id `default`. */
+    auto: true;
+    models: AgentModelInfo[];
+    note?: string;
+};
+/** Models available for one agent (or all when agent omitted). */
+declare function listModelsForAgent(agent?: AgentKind): Promise<AgentModelCatalog[]>;
+
+/**
+ * Provider session/usage quota (Claude “session limit”, weekly/opus caps, etc.).
+ * Not context-window overflow and not billing/credits.
+ */
+declare function isSessionQuotaLimit(text: string): boolean;
+/** Best-effort parse of “resets 7:10pm (America/Los_Angeles)” / “resets in 2 hours”. */
+declare function parseSessionQuotaResetAt(text: string, now?: Date): Date | null;
+/** Pick a different orchestrator-capable agent for quota failover. */
+declare function resolveQuotaFallbackAgent(current: AgentKind, preferred?: AgentKind | null): AgentKind;
+
+/**
+ * Agents that Sideboard can inject Sideboard MCP into for fleet orchestration.
+ * Brightsy CLI has no local MCP injection — it cannot be an orchestrator.
+ */
+declare const ORCHESTRATOR_AGENT_KINDS: readonly ["claude", "codex", "opencode", "cursor"];
+type OrchestratorAgentKind = (typeof ORCHESTRATOR_AGENT_KINDS)[number];
+declare function isOrchestratorCapableAgent(agent: AgentKind | null | undefined): agent is OrchestratorAgentKind;
+declare function assertOrchestratorCapableAgent(agent: AgentKind, context?: string): OrchestratorAgentKind;
+/** Prefer a capable agent; fall back to Claude when the choice is unsupported. */
+declare function coerceOrchestratorAgent(agent: AgentKind | null | undefined, fallback?: OrchestratorAgentKind): OrchestratorAgentKind;
+
 /**
  * Electron / GUI apps often inherit a minimal PATH that omits Homebrew and
  * user bin dirs where `claude` / `codex` / `opencode` / `brightsy` live. Call
@@ -1822,7 +1900,9 @@ declare function forkMessageSlice(from: Thread, throughIndex?: number): ThreadMe
 declare function buildForkTranscriptAttachment(baseTitle: string, messages: ThreadMessage[]): ThreadAttachment;
 /** New chat tab in the same worktree (no new git worktree). */
 declare function createChatTab(input: CreateChatTabInput): Thread;
-/** Fork chat into a new tab with transcript attached in the composer. */
+/** Fork chat into a new tab with transcript attached in the composer.
+ * Works for worktree agents and Global orchestration chats (same global home).
+ */
 declare function forkChatTab(input: ForkChatTabInput): Thread;
 
 /** Fork into a new git worktree branched from the source thread's branch. */
@@ -1901,6 +1981,8 @@ declare class Orchestrator {
     private readonly haltDrain;
     /** WIP snapshot SHA at the start of the latest agent turn (per thread). */
     private readonly turnBaselines;
+    /** Timers for orchestration session-quota auto-resume. */
+    private readonly quotaResumeTimers;
     private maxConcurrent;
     private runningCount;
     constructor(opts?: {
@@ -1924,6 +2006,16 @@ declare class Orchestrator {
          */
         reclaimStaleTurns?: boolean;
     }): Promise<void>;
+    private clearQuotaResumeTimer;
+    /** Schedule (or fire) auto-retry after a provider session/usage limit reset. */
+    private scheduleQuotaResume;
+    private schedulePendingQuotaResumes;
+    private resumeAfterQuotaWait;
+    /**
+     * Host-side continue when an orchestration chat hits a provider session/usage
+     * limit (not context size): switch agent (Auto) or wait until reset.
+     */
+    private maybeHandleOrchestrationQuotaFailover;
     getThreads(includeArchived?: boolean): Thread[];
     getThread(idOrRef: string): Thread | null;
     createThread(input: CreateThreadInput): Promise<Thread>;
@@ -2076,12 +2168,14 @@ declare class Orchestrator {
         threadId: string;
         throughIndex?: number;
         agent?: Thread['agent'];
+        model?: string | null;
         title?: string;
     }): Thread;
     forkThreadWorktree(input: {
         threadId: string;
         throughIndex?: number;
         agent?: Thread['agent'];
+        model?: string | null;
         title?: string;
     }): Promise<Thread>;
     renameThread(threadRef: string, title: string): Thread;
@@ -2777,4 +2871,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 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 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, 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, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, 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, 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, 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, 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, isOrchestratorThread, isPidAlive, isPlaceholderBranch, isThinkingEffort, 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, nextPastedTextName, nextThinkingEffort, normalizeParseResult, normalizeThinkingEffort, normalizeThread, normalizeTurnInput, normalizeWorktreePath, openInSystemTerminal, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, pastedTextStats, permissionMode, previewLand, pushBranch, readExistingReviewRequestFile, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requestReview, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveCursorModelId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, 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 { 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, REVIEW_REQUEST_NAME, REVIEW_REQUEST_PATH, REVIEW_REQUEST_PREFILL, type RepoSettings, type RepoSetupInfo, type RequestReviewResult, 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, 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, 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, resolveGithubRepoSlug, resolvePrSelector, resolveQuotaFallbackAgent, resolveRepoRoot, resolveThreadDefaults, resolveThreadEffort, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldAttachPastedText, shouldCompactContext, 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 };

package/dist/index.js

@@ -108,14 +108,14 @@ import {
   withAgentInstructions,
   worktreeCleanupSettings,
   writeWorktreeFile
-} from "./chunk-V3S4NF5F.js";
+} from "./chunk-7DTJFP4D.js";
 import {
   addWorkspace,
   ensureWorkspace,
   listWorkspaces,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-TXFJEXFB.js";
+} from "./chunk-SZAKJ4TR.js";
 import {
   CLOUD_COORDINATOR_BUSY_REPLY,
   CLOUD_COORDINATOR_STOPPED_REPLY,
@@ -135,7 +135,7 @@ import {
   orchestratorSessionPoisonedByBuiltins,
   parseForceStopMessage,
   takenTeamSlugsForOrchestration
-} from "./chunk-I3PKMLFW.js";
+} from "./chunk-SPCU3MFY.js";
 import {
   COORDINATOR_TOOL_PLAYBOOK,
   coordinatorSystemPrompt,
@@ -143,9 +143,10 @@ import {
   enrichWorkspacesWithGithub,
   ensureGlobalCoordinatorCwd,
   formatWorkspaceInventory
-} from "./chunk-JM2TVGNW.js";
+} from "./chunk-6NAPN2N5.js";
 import {
   BRIGHTSY_MCP_ALLOWED_TOOLS,
+  CLAUDE_MODEL_CATALOG,
   MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS,
   PLAN_MODE_INSTRUCTION,
   SIDEBOARD_MCP_ALLOWED_TOOLS,
@@ -167,10 +168,12 @@ import {
   installAgent,
   isBrightsyConnected,
   isCursorAutoModel,
+  isSessionQuotaLimit,
   listAgentSetupInfo,
   listBrightsyChatTargets,
   listCodexModels,
   listCursorModels,
+  listModelsForAgent,
   listOpencodeModels,
   loginAgent,
   mcpAllowTools,
@@ -179,11 +182,19 @@ import {
   openInSystemTerminal,
   opencodeAdapter,
   parseMcpList,
+  parseSessionQuotaResetAt,
   permissionMode,
   resolveCursorModelId,
+  resolveQuotaFallbackAgent,
   sanitizeMcpServerName,
   writeInjectedMcpConfig
-} from "./chunk-XX26NCB6.js";
+} from "./chunk-TQK2OYPU.js";
+import {
+  ORCHESTRATOR_AGENT_KINDS,
+  assertOrchestratorCapableAgent,
+  coerceOrchestratorAgent,
+  isOrchestratorCapableAgent
+} from "./chunk-GI7E5733.js";
 import {
   brightsyConfigPath,
   brightsyMcpServerName,
@@ -199,7 +210,7 @@ import {
 import {
   cursorSdkMessageToEvents,
   parseCursorRunnerLine
-} from "./chunk-PU27NUO4.js";
+} from "./chunk-J5JTEJ5O.js";
 import {
   HARNESS_ENV_KEYS,
   appSettingsPath,
@@ -225,6 +236,8 @@ import {
   isLinearConnected,
   loadAppSettings,
   maxConcurrentAgents,
+  orchestrationQuotaFallbackAgent,
+  orchestrationQuotaOnLimit,
   resolveClaudeExecutable,
   resolveEffectiveIssueSource,
   resolveThreadDefaults,
@@ -235,7 +248,7 @@ import {
   updateClaudeSettings,
   updateDefaultsSettings,
   updateIntegrationsSettings
-} from "./chunk-FSIK442J.js";
+} from "./chunk-T5QQVXK3.js";
 import {
   FAMOUS_SOCCER_TEAMS,
   allocateTeamName,
@@ -284,7 +297,7 @@ import {
   worktreeDisplayLabel,
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath
-} from "./chunk-7PCTK4WO.js";
+} from "./chunk-FV6FN6V5.js";
 import {
   appendMessage,
   createEmptyThread,
@@ -298,7 +311,7 @@ import {
   updateThread,
   withThreadLock,
   writeThread
-} from "./chunk-ENSD62HW.js";
+} from "./chunk-O6W3P7V3.js";
 import {
   THINKING_EFFORTS,
   isThinkingEffort,
@@ -796,6 +809,7 @@ async function runCloudConnect(opts) {
 export {
   BRIGHTSY_MCP_ALLOWED_TOOLS,
   BrightsySideboardApi,
+  CLAUDE_MODEL_CATALOG,
   CLOUD_COORDINATOR_BUSY_REPLY,
   CLOUD_COORDINATOR_STOPPED_REPLY,
   CLOUD_COORDINATOR_TIMEOUT_REPLY,
@@ -809,6 +823,7 @@ export {
   GLOBAL_WORKSPACE_ID,
   HARNESS_ENV_KEYS,
   MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS,
+  ORCHESTRATOR_AGENT_KINDS,
   Orchestrator,
   PASTE_ATTACH_MIN_CHARS,
   PASTE_ATTACH_MIN_LINES,
@@ -833,6 +848,7 @@ export {
   applyAppEnvironment,
   applyCompaction,
   applyThreadIntoMain,
+  assertOrchestratorCapableAgent,
   attachmentFromAbsolutePath,
   attachmentsFromBuffers,
   attachmentsFromWorktreePaths,
@@ -865,6 +881,7 @@ export {
   cleanupOrphanWorktrees,
   cloneRepoIntoSideboard,
   codexAdapter,
+  coerceOrchestratorAgent,
   collectTakenTeamSlugs,
   commitAll,
   conductorDbPath,
@@ -969,9 +986,11 @@ export {
   isGlobalThread,
   isImageFilePath,
   isLinearConnected,
+  isOrchestratorCapableAgent,
   isOrchestratorThread,
   isPidAlive,
   isPlaceholderBranch,
+  isSessionQuotaLimit,
   isThinkingEffort,
   listAgentSetupInfo,
   listBranchCommits,
@@ -987,6 +1006,7 @@ export {
   listIssues,
   listLinearIssues,
   listLinearIssuesDirect,
+  listModelsForAgent,
   listOpencodeModels,
   listPrs,
   listRunScripts,
@@ -1018,6 +1038,8 @@ export {
   normalizeWorktreePath,
   openInSystemTerminal,
   opencodeAdapter,
+  orchestrationQuotaFallbackAgent,
+  orchestrationQuotaOnLimit,
   orchestrationTitleNeedsSoccerNickname,
   orchestratorSessionPoisonedByBuiltins,
   originGhRepoEnv,
@@ -1025,6 +1047,7 @@ export {
   parseForceStopMessage,
   parseGithubSlugFromRemoteUrl,
   parseMcpList,
+  parseSessionQuotaResetAt,
   partsToAssistantText,
   pastedTextStats,
   permissionMode,
@@ -1051,6 +1074,7 @@ export {
   resolveFilesToCopy,
   resolveGithubRepoSlug,
   resolvePrSelector,
+  resolveQuotaFallbackAgent,
   resolveRepoRoot,
   resolveThreadDefaults,
   resolveThreadEffort,