@sideboard-ai/core 0.1.19 → 0.1.23

package/dist/index.d.cts

@@ -49,7 +49,7 @@ interface ThreadMessage {
 interface ThreadAttachment {
     id: string;
     name: string;
-    kind: 'transcript' | 'file' | 'issue' | 'workspace';
+    kind: 'transcript' | 'file' | 'issue' | 'workspace' | 'diff-comment';
     content: string;
 }
 interface Thread {
@@ -707,16 +707,17 @@ declare function formatGhLandError(raw: string, opts?: FormatGhLandErrorOptions)
 /** Strip Electron's IPC invoke wrapper, then humanize known gh failures. */
 declare function formatIpcInvokeError(err: unknown): string;
 
-/**
- * Memorable worktree / thread labels (Conductor-style nicknames).
- * Slug is the directory + `thread/<slug>` branch; `name` is the UI title.
- */
 interface TeamName {
     name: string;
     slug: string;
+    /** City / region where the club is based. */
+    location: string;
+    /** Top competition the club plays in. */
+    league: string;
 }
-/** Famous soccer clubs — short, recognizable thread labels. */
 declare const FAMOUS_SOCCER_TEAMS: readonly TeamName[];
+/** Resolve toast-ready club info from a thread title or worktree slug. */
+declare function lookupSoccerTeam(titleOrSlug: string): TeamName | null;
 declare function allocateTeamName(taken: Iterable<string>, random?: () => number): TeamName;
 
 /** Canonical worktree path for grouping tabs (browser-safe, no node:path). */
@@ -1211,6 +1212,11 @@ declare function formatRenameBranchDirective(thread: Pick<Thread, 'worktreePath'
 declare function formatWorktreeDirective(thread: Pick<Thread, 'worktreePath' | 'repoPath' | 'branchName'> & Partial<Pick<Thread, 'title' | 'prUrl'>>, opts?: {
     githubSlug?: string | null;
 }): string;
+/**
+ * Tell agents how Sideboard renders Claude-style artifacts (side column).
+ * Claude Code has no claude.ai `artifact` tool — fences / present_artifact instead.
+ */
+declare function formatArtifactDirective(): string;
 interface AgentInstructionFile {
     relativePath: string;
     content: string;
@@ -1416,6 +1422,17 @@ declare function getDiff(worktreePath: string, repoPath: string, opts?: GetDiffO
 declare function listWorktreeFiles(worktreePath: string, opts?: {
     maxFiles?: number;
 }): Promise<string[]>;
+/**
+ * Read a worktree file as base64 for upload (any type, not the editor stub).
+ * Rejects files larger than maxBytes.
+ */
+declare function readWorktreeFileForUpload(worktreePath: string, relativePath: string, opts?: {
+    maxBytes?: number;
+}): {
+    path: string;
+    contentBase64: string;
+    size: number;
+};
 /** Read a text (or image) file from the worktree (capped). */
 declare function readWorktreeFile(worktreePath: string, relativePath: string, opts?: {
     maxBytes?: number;
@@ -1479,6 +1496,23 @@ declare function expandComposerPrompt(worktreePath: string, prompt: string, opts
     attachments?: ThreadAttachment[];
 }): ExpandResult;
 
+interface DiffCommentLine {
+    side: 'add' | 'del' | 'context';
+    lineNo: number;
+    text: string;
+}
+interface DiffCommentInput {
+    path: string;
+    comment: string;
+    lines: DiffCommentLine[];
+    id?: string;
+}
+/**
+ * Build a composer attachment from a Changes/diff line selection + reviewer note.
+ * Expanded into agent context via `expandComposerPrompt` like other attachments.
+ */
+declare function buildDiffCommentAttachment(input: DiffCommentInput): ThreadAttachment;
+
 interface SummarizeResult {
     summary: string;
     method: 'claude' | 'extractive';
@@ -1754,6 +1788,11 @@ declare class Orchestrator {
         binary: boolean;
         encoding: 'utf8' | 'base64';
     }>;
+    readFileForUpload(threadRef: string, relativePath: string): Promise<{
+        path: string;
+        contentBase64: string;
+        size: number;
+    }>;
     writeFile(threadRef: string, relativePath: string, content: string): Promise<{
         path: string;
     }>;
@@ -1861,8 +1900,8 @@ declare function cloneRepoIntoSideboard(opts: {
 
 /**
  * Sideboard MCP server — agent-facing judgment surface.
- * Deliberately excludes ready-for-review confirm_land and purge_thread.
- * Draft PRs are allowed via create_draft_pr.
+ * Deliberately excludes ready-for-review confirm_land, purge_thread, and
+ * host-owned draft PR creation. Orchestrators ask worktree agents to open PRs.
  */
 declare function startMcpServer(): Promise<void>;
 
@@ -1940,6 +1979,17 @@ interface IpcApi {
     listBrightsyChatTargets(): Promise<BrightsyChatTargets>;
     /** Brightsy login + connected teams (shared by CLI, Brightsy agent, and Claude MCP). */
     getBrightsySession(): Promise<BrightsySession>;
+    /**
+     * Auth for schema CMS pane (`@brightsy/client` in the renderer).
+     * Returns null fields + reason when not logged in.
+     */
+    getBrightsyCmsAuth(): Promise<{
+        endpoint: string;
+        accessToken: string | null;
+        accountId: string | null;
+        accountSlug: string | null;
+        reason?: string;
+    }>;
     /** Connect/activate a team for CLI + MCP (same as connectBrightsyTeam). */
     switchBrightsyAccount(accountIdOrSlug: string): Promise<BrightsySession>;
     /** Connect a team for CLI + MCP; activates it as the CLI session. */
@@ -2038,6 +2088,12 @@ interface IpcApi {
         binary: boolean;
         encoding: 'utf8' | 'base64';
     }>;
+    /** Full file bytes (base64) for CMS / file-manager upload from worktree paths. */
+    readFileForUpload(threadRef: string, relativePath: string): Promise<{
+        path: string;
+        contentBase64: string;
+        size: number;
+    }>;
     writeFile(threadRef: string, relativePath: string, content: string): Promise<{
         path: string;
     }>;
@@ -2173,6 +2229,14 @@ interface IpcApi {
         exitCode: number | null;
     }>;
     openExternal(url: string): Promise<void>;
+    /**
+     * Publish HTML for the artifact side-column iframe (custom protocol bypasses
+     * renderer CSP so inline scripts can run).
+     */
+    publishArtifactPreview(id: string, html: string): Promise<{
+        url: string;
+    }>;
+    clearArtifactPreview(id: string): Promise<void>;
     /**
      * In-app URL preview via BrowserView (top-level navigation — works for
      * sites that block iframes, e.g. GitHub).
@@ -2352,7 +2416,7 @@ declare function disconnectBrightsyTeam(accountIdOrSlug: string): Promise<Connec
 /** Sanitize slug for Claude MCP server / tool name segments. */
 declare function brightsyMcpServerName(slug: string): string;
 
-/** Claude --allowedTools entries for Sideboard MCP. */
+/** Claude --allowedTools entries for Sideboard MCP (full fleet). */
 declare const SIDEBOARD_MCP_ALLOWED_TOOLS: readonly ["mcp__sideboard", "mcp__sideboard__*"];
 /** Legacy single-server allow list (CLI ~/.brightsy fallback). */
 declare const BRIGHTSY_MCP_ALLOWED_TOOLS: readonly ["mcp__brightsy", "mcp__brightsy__*"];
@@ -2369,4 +2433,4 @@ declare function writeInjectedMcpConfig(opts: {
     includeBrightsy?: boolean;
 }): Promise<string | null>;
 
-export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DevServerHandle, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };
+export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };

package/dist/index.d.ts

@@ -49,7 +49,7 @@ interface ThreadMessage {
 interface ThreadAttachment {
     id: string;
     name: string;
-    kind: 'transcript' | 'file' | 'issue' | 'workspace';
+    kind: 'transcript' | 'file' | 'issue' | 'workspace' | 'diff-comment';
     content: string;
 }
 interface Thread {
@@ -707,16 +707,17 @@ declare function formatGhLandError(raw: string, opts?: FormatGhLandErrorOptions)
 /** Strip Electron's IPC invoke wrapper, then humanize known gh failures. */
 declare function formatIpcInvokeError(err: unknown): string;
 
-/**
- * Memorable worktree / thread labels (Conductor-style nicknames).
- * Slug is the directory + `thread/<slug>` branch; `name` is the UI title.
- */
 interface TeamName {
     name: string;
     slug: string;
+    /** City / region where the club is based. */
+    location: string;
+    /** Top competition the club plays in. */
+    league: string;
 }
-/** Famous soccer clubs — short, recognizable thread labels. */
 declare const FAMOUS_SOCCER_TEAMS: readonly TeamName[];
+/** Resolve toast-ready club info from a thread title or worktree slug. */
+declare function lookupSoccerTeam(titleOrSlug: string): TeamName | null;
 declare function allocateTeamName(taken: Iterable<string>, random?: () => number): TeamName;
 
 /** Canonical worktree path for grouping tabs (browser-safe, no node:path). */
@@ -1211,6 +1212,11 @@ declare function formatRenameBranchDirective(thread: Pick<Thread, 'worktreePath'
 declare function formatWorktreeDirective(thread: Pick<Thread, 'worktreePath' | 'repoPath' | 'branchName'> & Partial<Pick<Thread, 'title' | 'prUrl'>>, opts?: {
     githubSlug?: string | null;
 }): string;
+/**
+ * Tell agents how Sideboard renders Claude-style artifacts (side column).
+ * Claude Code has no claude.ai `artifact` tool — fences / present_artifact instead.
+ */
+declare function formatArtifactDirective(): string;
 interface AgentInstructionFile {
     relativePath: string;
     content: string;
@@ -1416,6 +1422,17 @@ declare function getDiff(worktreePath: string, repoPath: string, opts?: GetDiffO
 declare function listWorktreeFiles(worktreePath: string, opts?: {
     maxFiles?: number;
 }): Promise<string[]>;
+/**
+ * Read a worktree file as base64 for upload (any type, not the editor stub).
+ * Rejects files larger than maxBytes.
+ */
+declare function readWorktreeFileForUpload(worktreePath: string, relativePath: string, opts?: {
+    maxBytes?: number;
+}): {
+    path: string;
+    contentBase64: string;
+    size: number;
+};
 /** Read a text (or image) file from the worktree (capped). */
 declare function readWorktreeFile(worktreePath: string, relativePath: string, opts?: {
     maxBytes?: number;
@@ -1479,6 +1496,23 @@ declare function expandComposerPrompt(worktreePath: string, prompt: string, opts
     attachments?: ThreadAttachment[];
 }): ExpandResult;
 
+interface DiffCommentLine {
+    side: 'add' | 'del' | 'context';
+    lineNo: number;
+    text: string;
+}
+interface DiffCommentInput {
+    path: string;
+    comment: string;
+    lines: DiffCommentLine[];
+    id?: string;
+}
+/**
+ * Build a composer attachment from a Changes/diff line selection + reviewer note.
+ * Expanded into agent context via `expandComposerPrompt` like other attachments.
+ */
+declare function buildDiffCommentAttachment(input: DiffCommentInput): ThreadAttachment;
+
 interface SummarizeResult {
     summary: string;
     method: 'claude' | 'extractive';
@@ -1754,6 +1788,11 @@ declare class Orchestrator {
         binary: boolean;
         encoding: 'utf8' | 'base64';
     }>;
+    readFileForUpload(threadRef: string, relativePath: string): Promise<{
+        path: string;
+        contentBase64: string;
+        size: number;
+    }>;
     writeFile(threadRef: string, relativePath: string, content: string): Promise<{
         path: string;
     }>;
@@ -1861,8 +1900,8 @@ declare function cloneRepoIntoSideboard(opts: {
 
 /**
  * Sideboard MCP server — agent-facing judgment surface.
- * Deliberately excludes ready-for-review confirm_land and purge_thread.
- * Draft PRs are allowed via create_draft_pr.
+ * Deliberately excludes ready-for-review confirm_land, purge_thread, and
+ * host-owned draft PR creation. Orchestrators ask worktree agents to open PRs.
  */
 declare function startMcpServer(): Promise<void>;
 
@@ -1940,6 +1979,17 @@ interface IpcApi {
     listBrightsyChatTargets(): Promise<BrightsyChatTargets>;
     /** Brightsy login + connected teams (shared by CLI, Brightsy agent, and Claude MCP). */
     getBrightsySession(): Promise<BrightsySession>;
+    /**
+     * Auth for schema CMS pane (`@brightsy/client` in the renderer).
+     * Returns null fields + reason when not logged in.
+     */
+    getBrightsyCmsAuth(): Promise<{
+        endpoint: string;
+        accessToken: string | null;
+        accountId: string | null;
+        accountSlug: string | null;
+        reason?: string;
+    }>;
     /** Connect/activate a team for CLI + MCP (same as connectBrightsyTeam). */
     switchBrightsyAccount(accountIdOrSlug: string): Promise<BrightsySession>;
     /** Connect a team for CLI + MCP; activates it as the CLI session. */
@@ -2038,6 +2088,12 @@ interface IpcApi {
         binary: boolean;
         encoding: 'utf8' | 'base64';
     }>;
+    /** Full file bytes (base64) for CMS / file-manager upload from worktree paths. */
+    readFileForUpload(threadRef: string, relativePath: string): Promise<{
+        path: string;
+        contentBase64: string;
+        size: number;
+    }>;
     writeFile(threadRef: string, relativePath: string, content: string): Promise<{
         path: string;
     }>;
@@ -2173,6 +2229,14 @@ interface IpcApi {
         exitCode: number | null;
     }>;
     openExternal(url: string): Promise<void>;
+    /**
+     * Publish HTML for the artifact side-column iframe (custom protocol bypasses
+     * renderer CSP so inline scripts can run).
+     */
+    publishArtifactPreview(id: string, html: string): Promise<{
+        url: string;
+    }>;
+    clearArtifactPreview(id: string): Promise<void>;
     /**
      * In-app URL preview via BrowserView (top-level navigation — works for
      * sites that block iframes, e.g. GitHub).
@@ -2352,7 +2416,7 @@ declare function disconnectBrightsyTeam(accountIdOrSlug: string): Promise<Connec
 /** Sanitize slug for Claude MCP server / tool name segments. */
 declare function brightsyMcpServerName(slug: string): string;
 
-/** Claude --allowedTools entries for Sideboard MCP. */
+/** Claude --allowedTools entries for Sideboard MCP (full fleet). */
 declare const SIDEBOARD_MCP_ALLOWED_TOOLS: readonly ["mcp__sideboard", "mcp__sideboard__*"];
 /** Legacy single-server allow list (CLI ~/.brightsy fallback). */
 declare const BRIGHTSY_MCP_ALLOWED_TOOLS: readonly ["mcp__brightsy", "mcp__brightsy__*"];
@@ -2369,4 +2433,4 @@ declare function writeInjectedMcpConfig(opts: {
     includeBrightsy?: boolean;
 }): Promise<string | null>;
 
-export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DevServerHandle, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };
+export { type ActiveRun, type AdoptInput, type AdvancedAppSettings, type AgentAdapter, type AgentEvent, type AgentInstructionFile, type AgentKind, type AgentStatus, type AgentTurnInput, type AnthropicCacheControl, type AppSettings, type ApplyIntoMainResult, type AttachCommand, type Autonomy, BRIGHTSY_MCP_ALLOWED_TOOLS, type BranchInfo, type BrightsyAccount, type BrightsyChatTarget, type BrightsyChatTargets, type BrightsyCloudConnectAgent, type BrightsyHarnessSettings, type BrightsySession, BrightsySideboardApi, type BrightsyTeamTargets, CLOUD_COORDINATOR_BUSY_REPLY, CLOUD_COORDINATOR_STOPPED_REPLY, CLOUD_COORDINATOR_TIMEOUT_REPLY, CLOUD_ORCHESTRATOR_GOAL, CONTEXT_COMPACT_CHARS, CONTEXT_KEEP_RECENT_CHARS, CONTEXT_KEEP_RECENT_MESSAGES, CONTEXT_MIN_MESSAGES, COORDINATOR_TOOL_PLAYBOOK, type ClaudeHarnessSettings, type CleanupOrphansResult, type CloudConnectAgent, type CloudConnectOptions, type CloudConnectStatus, type CompactResult, type CompactThresholds, type ConductorSettings, type ConductorWorkspace, type ConnectedBrightsyTeamInfo, type CreateChatTabInput, type CreateGlobalChatOpts, type CreateThreadInput, type CreateWorktreeResult, type CursorSdkStreamMessage, type CursorTurnRequest, type CursorWorktreesConfig, type DevServerHandle, type DiffCommentInput, type DiffCommentLine, type DiffCommit, type DiffFile, type DiffResult, type DiffScope, type DiffScopeStat, type ExpandResult, FAMOUS_SOCCER_TEAMS, type ForkChatTabInput, type ForkThreadWorktreeInput, type FormatGhLandErrorOptions, GLOBAL_WORKSPACE_ID, type GetDiffOptions, type GitHubStatus, type GitWorktreeStatus, HARNESS_ENV_KEYS, type HarnessId, type IntegrationsSettings, type IpcApi, type IssueInfo, type IssueSource, type LandPreview, type LandResult, type ListIssuesResult, MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS, type McpServerStatus, type MessagePart, Orchestrator, type OrchestratorEvent, type OrchestratorRuntime, type OrphanWorktree, PLAN_MODE_INSTRUCTION, type PrActor, type PrCheckRun, type PrCommentInfo, type PrCommitInfo, type PrDetails, type PrInfo, type PrMeta, type PrReviewInfo, type RepoSettings, type RepoSetupInfo, type RunMode, type RunScript, SIDEBOARD_FORCE_STOP, SIDEBOARD_MCP_ALLOWED_TOOLS, type ScriptHandle, type SkillInfo, type SourceType, type SpawnTurnHandle, type SummarizeResult, type TeamName, type Thread, type ThreadAttachment, type ThreadMessage, type ThreadOptionsPatch, type ThreadStatus, type TokenUsage, type TranscriptToolDetail, type TurnCommand, type Workspace, type WorkspaceInventoryEntry, type WorkspaceScriptEnvOpts, addWorkspace, adoptThread, allAdapters, allocatePort, allocatePortRange, allocateTeamName, allocateTeamSlug, appDataDir, appSettingsPath, appendMessage, applyAgentEvent, applyAppEnvironment, applyCompaction, applyThreadIntoMain, autoCleanupOrphansEnabled, autoRenameBranchEnabled, autoRunAfterSetupEnabled, branchDisplayLabel, brightsyAdapter, brightsyCloudConnectAgent, brightsyCloudConnectEnabled, brightsyConfigPath, brightsyMcpAllowedTools, brightsyMcpServerName, buildCachedUserContent, buildClaudeStreamJsonUserMessage, buildDiffCommentAttachment, buildForkTranscriptAttachment, buildSessionSeed, buildWorkspaceScriptEnv, caffeinateWhileCloudConnectEnabled, caffeinateWhileRunningEnabled, captureLoginEnv, captureTurnBaseline, childEnvWithAppSettings, claudeAdapter, claudeChromeEnabled, claudeUserSettingsPath, cleanupOrphanWorktrees, cloneRepoIntoSideboard, codexAdapter, collectTakenTeamSlugs, commitAll, conductorDbPath, confirmLand, connectBrightsyTeam, coordinatorSystemPrompt, coordinatorTurnReminder, copyConfiguredFiles, countCacheControlBlocks, createChatTab, createEmptyThread, createGlobalChat, createOrUpdatePr, createThread, createThreadWorktree, currentBranch, cursorAdapter, cursorSdkMessageToEvents, decodeBrightsyTarget, deleteBranchOnPurgeEnabled, deleteThreadRecord, detectAgents, detectLocalMergeConflicts, disconnectBrightsyTeam, discoverSkills, encodeBrightsyTarget, enrichWorkspacesWithGithub, ensureAgentPath, ensureCloudCoordinator, ensureGhPreferOrigin, ensureGlobalCoordinatorCwd, ensureWorkspace, estimateMessageChars, estimateThreadChars, expandComposerPrompt, extractGhErrorDetail, extractiveSummary, fetchPrHead, finalizeParts, findInvalidCacheControlTtlOrder, findOrphanWorktrees, findThreadByRef, flattenTurnInput, forkChatTab, forkMessageSlice, forkThreadWorktree, formatAgentInstructions, formatArtifactDirective, formatBrightsyFetchError, formatGhLandError, formatIpcInvokeError, formatMessagesAsTranscript, formatRateLimitResetHint, formatRenameBranchDirective, formatTranscriptMarkdown, formatWorkspaceInventory, formatWorktreeDirective, getAdapter, getBrightsySession, getDefaultRunScript, getDiff, getDiffSummary, getGitHubStatus, getIssueSource, getLinearApiKey, getOrchestrator, getPr, getPrChecks, getPrDetails, getPrMeta, getRepoSetupInfo, getRunMode, getRunScript, gh, ghHeadRef, ghRepoSelectArgs, git, globalAgentCwd, harnessEnvKey, hasConductorHook, hasCursorWorktreeSetup, hasRepoHook, hasWorkspaceHook, healOrchestrationSoccerTitles, importConductorWorkspace, importConductorWorkspaceAsync, initializeGitRepository, inspectGitWorktree, isBrightsyConnected, isBrightsyNdjsonLine, isCloudCoordinatorThread, isDirty, isGhRateLimitError, isGlobalRepoPath, isGlobalThread, isLinearConnected, isOrchestratorThread, isPlaceholderBranch, listBranchCommits, listBranches, listBrightsyAccounts, listBrightsyChatTargets, listConductorWorkspaces, listConnectedBrightsyTeams, listGitHubIssues, listGlobalThreads, listIssues, listLinearIssues, listLinearIssuesDirect, listPrs, listRunScripts, listThreads, listWorkspaces, listWorktreeFiles, listWorktrees, loadAgentInstructions, loadAppSettings, loadBrightsyConfig, loadConductorSettings, loadRepoSettings, loadWorkspaceSettings, locksDir, lookupSoccerTeam, maxConcurrentAgents, maybeCompactContext, mcpAllowTools, mcpAuthWarnings, mergePr, mergeUsage, normalizeParseResult, normalizeThread, normalizeTurnInput, normalizeWorktreePath, opencodeAdapter, orchestrationTitleNeedsSoccerNickname, orchestratorSessionPoisonedByBuiltins, originGhRepoEnv, parseCursorRunnerLine, parseForceStopMessage, parseGithubSlugFromRemoteUrl, parseMcpList, partsToAssistantText, permissionMode, previewLand, pushBranch, readSkillBody, readThread, readWorktreeFile, readWorktreeFileForUpload, readWorktreeInclude, refreshGitHubAuth, removeWorkspace, removeWorktree, repoSlug, requireAgent, resolveClaudeExecutable, resolveConductorCursorAgentId, resolveDefaultBranch, resolveDiffBaseRef, resolveEffectiveIssueSource, resolveFilesToCopy, resolveGithubRepoSlug, resolvePrSelector, resolveRepoRoot, resolveWorktreeStartPoint, run, runArchiveScript, runCloudConnect, runCursorWorktreeSetup, runSetupScript, sameWorktreePath, sanitizeMcpServerName, saveAppSettings, setStatus, settingsSourceLabel, shouldCompactContext, shouldRunWorktreeCleanup, sideboardHomeDir, sideboardReposDir, sideboardWorkspacesDir, slugify, spawnAgentTurn, splitForCompaction, startDevServer, startMcpServer, startOrchestration, stripBrightsyNdjsonNoise, suggestSlug, summarizeConversation, switchBrightsyAccount, syncWorkspacesFromThreads, takenTeamSlugsForChatTab, takenTeamSlugsForOrchestration, taskMessageText, threadDisplayLabel, threadFilePath, threadLockPath, threadsDir, threadsSharingWorktree, toolDescription, toolDetail, toolFilePath, totalTokens, updateAdvancedSettings, updateAppEnvironment, updateBrightsySettings, updateClaudeSettings, updateIntegrationsSettings, updateThread, validateLinearApiKey, withAgentInstructions, withThreadLock, workspaceSettingsSourceLabel, worktreeCleanupSettings, worktreeDisplayLabel, worktreeDisplayLabelForGroup, worktreeNameFromPath, worktreesRoot, writeInjectedMcpConfig, writeThread, writeWorktreeFile };

package/dist/index.js

@@ -34,6 +34,7 @@ import {
   forkMessageSlice,
   forkThreadWorktree,
   formatAgentInstructions,
+  formatArtifactDirective,
   formatMessagesAsTranscript,
   formatRenameBranchDirective,
   formatTranscriptMarkdown,
@@ -66,6 +67,7 @@ import {
   previewLand,
   readSkillBody,
   readWorktreeFile,
+  readWorktreeFileForUpload,
   readWorktreeInclude,
   requireAgent,
   resolveConductorCursorAgentId,
@@ -93,14 +95,14 @@ import {
   withAgentInstructions,
   worktreeCleanupSettings,
   writeWorktreeFile
-} from "./chunk-WWBC56EL.js";
+} from "./chunk-JNMLRJ3D.js";
 import {
   addWorkspace,
   ensureWorkspace,
   listWorkspaces,
   removeWorkspace,
   syncWorkspacesFromThreads
-} from "./chunk-LIUV5ONW.js";
+} from "./chunk-PER4N6LS.js";
 import {
   CLOUD_COORDINATOR_BUSY_REPLY,
   CLOUD_COORDINATOR_STOPPED_REPLY,
@@ -120,7 +122,7 @@ import {
   orchestratorSessionPoisonedByBuiltins,
   parseForceStopMessage,
   takenTeamSlugsForOrchestration
-} from "./chunk-5263JXQY.js";
+} from "./chunk-Y2EWQ4TL.js";
 import {
   COORDINATOR_TOOL_PLAYBOOK,
   coordinatorSystemPrompt,
@@ -128,7 +130,7 @@ import {
   enrichWorkspacesWithGithub,
   ensureGlobalCoordinatorCwd,
   formatWorkspaceInventory
-} from "./chunk-SNHWAARD.js";
+} from "./chunk-BMB7WCGF.js";
 import {
   BRIGHTSY_MCP_ALLOWED_TOOLS,
   MAX_ANTHROPIC_CACHE_CONTROL_BLOCKS,
@@ -158,7 +160,7 @@ import {
   permissionMode,
   sanitizeMcpServerName,
   writeInjectedMcpConfig
-} from "./chunk-JQJZTL2Q.js";
+} from "./chunk-WK6AK7NK.js";
 import {
   brightsyConfigPath,
   brightsyMcpServerName,
@@ -234,6 +236,7 @@ import {
   listBranches,
   listPrs,
   listWorktrees,
+  lookupSoccerTeam,
   mergePr,
   normalizeWorktreePath,
   originGhRepoEnv,
@@ -252,7 +255,7 @@ import {
   worktreeDisplayLabel,
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath
-} from "./chunk-LXHSRNJJ.js";
+} from "./chunk-UFWEANLU.js";
 import {
   appendMessage,
   createEmptyThread,
@@ -342,6 +345,53 @@ async function refreshGitHubAuth() {
   return getGitHubStatus();
 }
 
+// src/composer/diff-comment.ts
+function lineRangeLabel(lines) {
+  const nos = lines.map((l) => l.lineNo);
+  const start = Math.min(...nos);
+  const end = Math.max(...nos);
+  return start === end ? `L${start}` : `L${start}-${end}`;
+}
+function formatDiffBody(lines) {
+  return lines.map((l) => {
+    const prefix = l.side === "add" ? "+" : l.side === "del" ? "-" : " ";
+    return `${prefix}${l.text}`;
+  }).join("\n");
+}
+function buildDiffCommentAttachment(input) {
+  const comment = input.comment.trim();
+  if (!input.path.trim()) {
+    throw new Error("diff comment requires a file path");
+  }
+  if (!comment) {
+    throw new Error("diff comment requires a note");
+  }
+  if (input.lines.length === 0) {
+    throw new Error("diff comment requires at least one cited line");
+  }
+  const range = lineRangeLabel(input.lines);
+  const name = `${input.path}:${range}`;
+  const content = [
+    `Diff review comment on \`${input.path}\` (${range}).`,
+    "",
+    "Address this feedback on the cited lines. Prefer a precise fix over rewriting unrelated code.",
+    "",
+    "### Reviewer comment",
+    comment,
+    "",
+    "### Cited diff",
+    "```diff",
+    formatDiffBody(input.lines),
+    "```"
+  ].join("\n");
+  return {
+    id: input.id ?? `diff-comment-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+    name,
+    kind: "diff-comment",
+    content
+  };
+}
+
 // src/brightsy/api.ts
 function formatBrightsyFetchError(err, url) {
   if (!(err instanceof Error)) return `${String(err)} (${url})`;
@@ -714,6 +764,7 @@ export {
   brightsyMcpServerName,
   buildCachedUserContent,
   buildClaudeStreamJsonUserMessage,
+  buildDiffCommentAttachment,
   buildForkTranscriptAttachment,
   buildSessionSeed,
   buildWorkspaceScriptEnv,
@@ -775,6 +826,7 @@ export {
   forkMessageSlice,
   forkThreadWorktree,
   formatAgentInstructions,
+  formatArtifactDirective,
   formatBrightsyFetchError,
   formatGhLandError,
   formatIpcInvokeError,
@@ -849,6 +901,7 @@ export {
   loadRepoSettings,
   loadWorkspaceSettings,
   locksDir,
+  lookupSoccerTeam,
   maxConcurrentAgents,
   maybeCompactContext,
   mcpAllowTools,
@@ -874,6 +927,7 @@ export {
   readSkillBody,
   readThread,
   readWorktreeFile,
+  readWorktreeFileForUpload,
   readWorktreeInclude,
   refreshGitHubAuth,
   removeWorkspace,