workspace

type AliasConflictError struct {
	Alias        string
	ExistingPath string
}

type Config struct {
	User      UserConfig      `json:"user"`
	Providers ProvidersConfig `json:"providers"`
	Gateways  GatewaysConfig  `json:"gateways"`
	Runtime   RuntimeConfig   `json:"runtime"`
	Storage   StorageConfig   `json:"storage"`
	Server    ServerConfig    `json:"server"`
	Cron      CronConfig      `json:"cron"`
	Logs      LogsConfig      `json:"logs"`
	UI        UIConfig        `json:"ui"`
	Version   int             `json:"version"`
}

type CronConfig struct {
	PollIntervalSeconds int `json:"poll_interval_seconds"`
	JobTimeoutSeconds   int `json:"job_timeout_seconds"`
}

type DiscordGatewayConfig struct {
	BotToken string `json:"bot_token"`
	Enabled  bool   `json:"enabled"`
}

type DiscoverOptions struct {
	// ScanPaths additional paths to scan for workspaces
	ScanPaths []string
	// MaxDepth maximum directory depth to scan (default 3)
	MaxDepth int
	// IncludeCached includes workspaces from the global registry (~/.bc/workspaces.json)
	IncludeCached bool
	// ScanHome scans ~/Projects and ~/Developer directories
	ScanHome bool
}

type DiscoveredWorkspace struct {
	Path      string // Absolute path to workspace root
	Name      string // Workspace name (from config or directory name)
	IsV2      bool   // True if v2 (TOML) workspace
	FromCache bool   // True if found in registry (not disk scan)
}

type DockerRuntimeConfig struct {
	ExtraMounts      []string `json:"extra_mounts"`
	Image            string   `json:"image"`
	Network          string   `json:"network"`
	DockerSocketPath string   `json:"docker_socket_path"`
	MemoryMB         int64    `json:"memory_mb"`
	CPUs             float64  `json:"cpus"`
}

type GatewaysConfig struct {
	Telegram *TelegramGatewayConfig `json:"telegram,omitempty"`
	Discord  *DiscordGatewayConfig  `json:"discord,omitempty"`
	Slack    *SlackGatewayConfig    `json:"slack,omitempty"`
}

type LogsConfig struct {
	Path     string `json:"path"`
	MaxBytes int64  `json:"max_bytes"`
}

type MigrateResult struct {
	BackupPath     string // Path to backup of old .bc directory
	AgentFiles     int    // Number of agent state files migrated
	ConfigMigrated bool   // Whether config.json → settings.json migration ran
	ChannelJSON    bool   // Whether channels.json was migrated to SQLite
}

type ProviderConfig struct {
	Command string `json:"command"`
}

type ProvidersConfig struct {
	Default   string                    `json:"default"`
	Providers map[string]ProviderConfig `json:"providers,omitempty"`
}

type Registry struct {
	Active     string          `json:"active,omitempty"` // Path or alias of active workspace
	Workspaces []RegistryEntry `json:"workspaces"`
	// contains filtered or unexported fields
}

type RegistryEntry struct {
	CreatedAt    time.Time `json:"created_at"`
	LastAccessed time.Time `json:"last_accessed"`
	Path         string    `json:"path"`
	Name         string    `json:"name"`
	Alias        string    `json:"alias,omitempty"` // Short alias for quick access (#1218)
}

type ResolvedRole struct {
	Settings     map[string]any    // Merged settings (child overrides parent)
	Rules        map[string]string // Merged rule files (child overrides parent)
	Agents       map[string]string // Merged agent templates
	Skills       map[string]string // Merged skill files
	Commands     map[string]string // Merged command files
	PromptStart  string            // Lifecycle: sent on agent start/restart
	Name         string            // Role name
	PromptStop   string            // Lifecycle: sent on agent stop
	PromptDelete string            // Lifecycle: sent on agent delete
	PromptCreate string            // Lifecycle: sent on agent create
	Prompt       string            // Merged prompt body (child + parent)
	Review       string            // REVIEW.md content
	Plugins      []string          // Unioned plugins from all ancestors
	Secrets      []string          // Unioned secret names from all ancestors
	MCPServers   []string          // Unioned MCP servers from all ancestors
	CLITools     []string          // Unioned CLI tools from all ancestors
	Description  string            // Human-readable role description
}

type Role struct {
	FilePath string       // Path to the role file
	Prompt   string       // Markdown body after frontmatter
	Metadata RoleMetadata // Parsed YAML frontmatter
}

type RoleManager struct {
	// contains filtered or unexported fields
}

type RoleMetadata struct {
	Settings     map[string]any    `yaml:"settings,omitempty"`      // Claude settings overrides (e.g., model, permissions)
	Rules        map[string]string `yaml:"rules,omitempty"`         // Rule files written to .claude/rules/*.md
	Agents       map[string]string `yaml:"agents,omitempty"`        // Agent templates written to .claude/agents/*.md
	Skills       map[string]string `yaml:"skills,omitempty"`        // Skill files written to .claude/skills/*.md
	Commands     map[string]string `yaml:"commands,omitempty"`      // Command files written to .claude/commands/*.md
	PromptStop   string            `yaml:"prompt_stop,omitempty"`   // Sent when agent is stopped
	PromptCreate string            `yaml:"prompt_create,omitempty"` // Sent when agent is created
	PromptStart  string            `yaml:"prompt_start,omitempty"`  // Sent when agent is started/restarted
	Name         string            `yaml:"name"`                    // Role name (e.g., "engineer", "manager")
	PromptDelete string            `yaml:"prompt_delete,omitempty"` // Sent when agent is deleted
	Description  string            `yaml:"description,omitempty"`   // Human-readable role description
	Review       string            `yaml:"review,omitempty"`        // REVIEW.md content for the role
	Plugins      []string          `yaml:"plugins,omitempty"`       // Claude Code plugins to install on agent start
	Secrets      []string          `yaml:"secrets,omitempty"`       // Secret names needed by MCP env vars
	MCPServers   []string          `yaml:"mcp_servers,omitempty"`   // MCP servers available to this role
	ParentRoles  []string          `yaml:"parent_roles,omitempty"`  // Roles to inherit from (capabilities, prompts)
	CLITools     []string          `yaml:"cli_tools,omitempty"`     // CLI tools expected in agent PATH (e.g., gh, aws, wrangler)
}

type RoleStore struct {
	// contains filtered or unexported fields
}

type RuntimeConfig struct {
	K8s     json.RawMessage     `json:"k8s,omitempty"` // future
	Default string              `json:"default"`       // "tmux" or "docker"
	Docker  DockerRuntimeConfig `json:"docker"`
	Tmux    TmuxRuntimeConfig   `json:"tmux"`
}

type SQLiteStorageConfig struct {
	Path string `json:"path"`
}

type ServerConfig struct {
	Host       string `json:"host"`
	CORSOrigin string `json:"cors_origin"`
	Port       int    `json:"port"`
}

type SlackGatewayConfig struct {
	BotToken string `json:"bot_token"`
	AppToken string `json:"app_token"`
	Mode     string `json:"mode"`
	Enabled  bool   `json:"enabled"`
}

type StorageConfig struct {
	Default   string                 `json:"default"` // "sqlite" or "timescale"
	SQLite    SQLiteStorageConfig    `json:"sqlite"`
	Timescale TimescaleStorageConfig `json:"timescale"`
}

type TelegramGatewayConfig struct {
	BotToken string `json:"bot_token"`
	Mode     string `json:"mode"`
	Enabled  bool   `json:"enabled"`
}

type TimescaleStorageConfig struct {
	Host     string `json:"host"`
	User     string `json:"user"`
	Password string `json:"password"`
	Database string `json:"database"`
	Port     int    `json:"port"`
}

type TmuxRuntimeConfig struct {
	SessionPrefix string `json:"session_prefix"`
	DefaultShell  string `json:"default_shell"`
	HistoryLimit  int    `json:"history_limit"`
}

type UIConfig struct {
	Theme       string `json:"theme"`
	Mode        string `json:"mode"`
	DefaultView string `json:"default_view"`
}

type UserConfig struct {
	Name string `json:"name"`
}

type UserRCConfig struct {
	User     UserRCUserConfig     `json:"user"`
	Defaults UserRCDefaultsConfig `json:"defaults"`
	Tools    UserRCToolsConfig    `json:"tools"`
}

type UserRCDefaultsConfig struct {
	DefaultRole   string `json:"default_role,omitempty"`
	AutoStartRoot bool   `json:"auto_start_root,omitempty"`
}

type UserRCToolsConfig struct {
	Preferred []string `json:"preferred,omitempty"`
}

type UserRCUserConfig struct {
	Nickname string `json:"nickname,omitempty"`
}

type V1Config struct {
	Name        string            `json:"name"`
	Description string            `json:"description"`
	Provider    string            `json:"provider"`  // default provider name
	Command     string            `json:"command"`   // default provider command
	Providers   map[string]string `json:"providers"` // name → command
	Nickname    string            `json:"nickname"`  // user nickname
	Runtime     string            `json:"runtime"`   // "tmux" or "docker"
}

type Workspace struct {
	Config      *Config      // JSON config
	RoleManager *RoleManager // Role file manager
	RootDir     string       // Project root directory
	// contains filtered or unexported fields
}

type WorkspaceNotFoundError struct {
	Identifier string
}