mirror of
https://github.com/tiennm99/ccs.git
synced 2026-07-16 04:18:05 +00:00
refactor(config): reorganize unified-config-types into schemas directory
Split the 1,128-line unified-config-types.ts into focused schema modules under src/config/schemas/ for maintainability. Each file is under 200 LOC. New schema files: - version.ts: UNIFIED_CONFIG_VERSION constant - auth.ts: AccountConfig, ProfileConfig, OAuthAccounts, CLIProxyAuthConfig, etc. - cliproxy.ts: CLIProxyConfig, CompositeTierConfig, routing/safety types - copilot-cursor.ts: CopilotConfig, CursorConfig + defaults - proxy-server.ts: CliproxyServerConfig, GlobalEnvConfig, ImageAnalysisConfig - quota.ts: QuotaManagementConfig + all quota types and defaults - thinking.ts: ThinkingConfig + tier defaults - channels.ts: OfficialChannelsConfig (Telegram, Discord, iMessage) - websearch.ts: All WebSearch backend types (DuckDuckGo, Brave, Exa, etc.) - browser.ts: BrowserConfig, BrowserClaudeConfig, BrowserCodexConfig - logging.ts: LoggingConfig, PreferencesConfig - unified-config.ts: UnifiedConfig interface, factory, type guard - index.ts: Barrel re-export of all schema modules unified-config-types.ts is now a thin backward-compatible barrel that re-exports everything from schemas/index. All 67 existing imports across the codebase continue to resolve unchanged.
This commit is contained in:
Tam Nhu Tran
@@ -0,0 +1,198 @@
|
||||
/**
|
||||
* Tests: config schemas re-export backward compatibility.
|
||||
*
|
||||
* Verifies that every type, interface, constant, and function originally
|
||||
* exported from unified-config-types.ts is still accessible via both
|
||||
* the barrel file and the schemas/index barrel.
|
||||
*/
|
||||
|
||||
import { describe, it, expect } from 'bun:test';
|
||||
|
||||
// Import from the backward-compatible barrel (this is what all existing code uses)
|
||||
import * as barrel from '../../unified-config-types';
|
||||
|
||||
// Import from the new schemas barrel (this is what the barrel delegates to)
|
||||
import * as schemas from '../index';
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// Type-level checks (compile-time, not runtime)
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
// Verify key interfaces are accessible as types
|
||||
import type {
|
||||
UnifiedConfig,
|
||||
AccountConfig,
|
||||
ProfileConfig,
|
||||
OAuthAccounts,
|
||||
CLIProxyAuthConfig,
|
||||
TokenRefreshSettings,
|
||||
DashboardAuthConfig,
|
||||
CLIProxyVariantConfig,
|
||||
CompositeTierConfig,
|
||||
CompositeVariantConfig,
|
||||
CLIProxyLoggingConfig,
|
||||
CLIProxySafetyConfig,
|
||||
CLIProxyRoutingConfig,
|
||||
CLIProxyConfig,
|
||||
AutoQuotaConfig,
|
||||
RuntimeMonitorConfig,
|
||||
ManualQuotaConfig,
|
||||
QuotaManagementMode,
|
||||
QuotaManagementConfig,
|
||||
ThinkingMode,
|
||||
ThinkingTierDefaults,
|
||||
ThinkingConfig,
|
||||
OfficialChannelId,
|
||||
OfficialChannelsConfig,
|
||||
DuckDuckGoWebSearchConfig,
|
||||
BraveWebSearchConfig,
|
||||
ExaWebSearchConfig,
|
||||
TavilyWebSearchConfig,
|
||||
SearxngWebSearchConfig,
|
||||
GeminiWebSearchConfig,
|
||||
GrokWebSearchConfig,
|
||||
OpenCodeWebSearchConfig,
|
||||
WebSearchProvidersConfig,
|
||||
WebSearchConfig,
|
||||
BrowserToolPolicy,
|
||||
BrowserEvalMode,
|
||||
BrowserClaudeConfig,
|
||||
BrowserCodexConfig,
|
||||
BrowserConfig,
|
||||
LoggingLevel,
|
||||
LoggingConfig,
|
||||
PreferencesConfig,
|
||||
CopilotAccountType,
|
||||
CopilotConfig,
|
||||
CursorConfig,
|
||||
ProxyRemoteConfig,
|
||||
ProxyFallbackConfig,
|
||||
ProxyLocalConfig,
|
||||
OpenAICompatProxyRoutingConfig,
|
||||
OpenAICompatProxyConfig,
|
||||
CliproxyServerConfig,
|
||||
GlobalEnvConfig,
|
||||
ContinuityConfig,
|
||||
ImageAnalysisConfig,
|
||||
} from '../../unified-config-types';
|
||||
|
||||
describe('config schemas backward compatibility', () => {
|
||||
// -------------------------------------------------------------------------
|
||||
// Constants
|
||||
// -------------------------------------------------------------------------
|
||||
it('re-exports UNIFIED_CONFIG_VERSION', () => {
|
||||
expect(barrel.UNIFIED_CONFIG_VERSION).toBe(13);
|
||||
expect(schemas.UNIFIED_CONFIG_VERSION).toBe(13);
|
||||
});
|
||||
|
||||
it('re-exports CLIPROXY_SUPPORTED_PROVIDERS', () => {
|
||||
expect(Array.isArray(barrel.CLIPROXY_SUPPORTED_PROVIDERS)).toBe(true);
|
||||
expect(barrel.CLIPROXY_SUPPORTED_PROVIDERS.length).toBeGreaterThan(0);
|
||||
expect(barrel.CLIPROXY_SUPPORTED_PROVIDERS).toEqual(schemas.CLIPROXY_SUPPORTED_PROVIDERS);
|
||||
});
|
||||
|
||||
// -------------------------------------------------------------------------
|
||||
// Default constants
|
||||
// -------------------------------------------------------------------------
|
||||
const defaultConstants = [
|
||||
'DEFAULT_CLIPROXY_SAFETY_CONFIG',
|
||||
'DEFAULT_LOGGING_CONFIG',
|
||||
'DEFAULT_OFFICIAL_CHANNELS_CONFIG',
|
||||
'DEFAULT_BROWSER_CONFIG',
|
||||
'DEFAULT_DASHBOARD_AUTH_CONFIG',
|
||||
'DEFAULT_AUTO_QUOTA_CONFIG',
|
||||
'DEFAULT_MANUAL_QUOTA_CONFIG',
|
||||
'DEFAULT_RUNTIME_MONITOR_CONFIG',
|
||||
'DEFAULT_QUOTA_MANAGEMENT_CONFIG',
|
||||
'DEFAULT_THINKING_TIER_DEFAULTS',
|
||||
'DEFAULT_THINKING_CONFIG',
|
||||
'DEFAULT_COPILOT_CONFIG',
|
||||
'DEFAULT_CURSOR_CONFIG',
|
||||
'DEFAULT_CLIPROXY_SERVER_CONFIG',
|
||||
'DEFAULT_OPENAI_COMPAT_PROXY_CONFIG',
|
||||
'DEFAULT_GLOBAL_ENV',
|
||||
'DEFAULT_IMAGE_ANALYSIS_CONFIG',
|
||||
] as const;
|
||||
|
||||
for (const name of defaultConstants) {
|
||||
it(`re-exports ${name}`, () => {
|
||||
expect(barrel[name]).toBeDefined();
|
||||
expect(barrel[name]).toEqual(schemas[name]);
|
||||
});
|
||||
}
|
||||
|
||||
// -------------------------------------------------------------------------
|
||||
// Functions
|
||||
// -------------------------------------------------------------------------
|
||||
it('re-exports createEmptyUnifiedConfig', () => {
|
||||
expect(typeof barrel.createEmptyUnifiedConfig).toBe('function');
|
||||
expect(typeof schemas.createEmptyUnifiedConfig).toBe('function');
|
||||
|
||||
const config = barrel.createEmptyUnifiedConfig();
|
||||
expect(config.version).toBe(13);
|
||||
expect(config.accounts).toEqual({});
|
||||
expect(config.profiles).toEqual({});
|
||||
expect(config.cliproxy).toBeDefined();
|
||||
expect(config.cliproxy.oauth_accounts).toEqual({});
|
||||
expect(config.cliproxy.variants).toEqual({});
|
||||
expect(config.logging).toBeDefined();
|
||||
expect(config.preferences).toBeDefined();
|
||||
expect(config.browser).toBeDefined();
|
||||
expect(config.image_analysis).toBeDefined();
|
||||
expect(config.quota_management).toBeDefined();
|
||||
expect(config.thinking).toBeDefined();
|
||||
expect(config.channels).toBeDefined();
|
||||
expect(config.dashboard_auth).toBeDefined();
|
||||
expect(config.copilot).toBeDefined();
|
||||
expect(config.cursor).toBeDefined();
|
||||
expect(config.cliproxy_server).toBeDefined();
|
||||
expect(config.websearch).toBeDefined();
|
||||
});
|
||||
|
||||
it('re-exports isUnifiedConfig', () => {
|
||||
expect(typeof barrel.isUnifiedConfig).toBe('function');
|
||||
expect(typeof schemas.isUnifiedConfig).toBe('function');
|
||||
|
||||
expect(barrel.isUnifiedConfig({ version: 13 })).toBe(true);
|
||||
expect(barrel.isUnifiedConfig(null)).toBe(false);
|
||||
expect(barrel.isUnifiedConfig({})).toBe(false);
|
||||
expect(barrel.isUnifiedConfig({ version: 0 })).toBe(false);
|
||||
expect(barrel.isUnifiedConfig({ version: 1 })).toBe(true);
|
||||
expect(barrel.isUnifiedConfig('not an object')).toBe(false);
|
||||
});
|
||||
|
||||
// -------------------------------------------------------------------------
|
||||
// Barrel has all expected runtime exports (type-only exports are verified
|
||||
// at compile time via the import type block above — they are erased at
|
||||
// runtime and cannot be checked with the `in` operator).
|
||||
// -------------------------------------------------------------------------
|
||||
const expectedRuntimeExports = [
|
||||
'UNIFIED_CONFIG_VERSION',
|
||||
'CLIPROXY_SUPPORTED_PROVIDERS',
|
||||
'createEmptyUnifiedConfig',
|
||||
'isUnifiedConfig',
|
||||
'DEFAULT_CLIPROXY_SAFETY_CONFIG',
|
||||
'DEFAULT_LOGGING_CONFIG',
|
||||
'DEFAULT_OFFICIAL_CHANNELS_CONFIG',
|
||||
'DEFAULT_BROWSER_CONFIG',
|
||||
'DEFAULT_DASHBOARD_AUTH_CONFIG',
|
||||
'DEFAULT_AUTO_QUOTA_CONFIG',
|
||||
'DEFAULT_MANUAL_QUOTA_CONFIG',
|
||||
'DEFAULT_RUNTIME_MONITOR_CONFIG',
|
||||
'DEFAULT_QUOTA_MANAGEMENT_CONFIG',
|
||||
'DEFAULT_THINKING_TIER_DEFAULTS',
|
||||
'DEFAULT_THINKING_CONFIG',
|
||||
'DEFAULT_COPILOT_CONFIG',
|
||||
'DEFAULT_CURSOR_CONFIG',
|
||||
'DEFAULT_CLIPROXY_SERVER_CONFIG',
|
||||
'DEFAULT_OPENAI_COMPAT_PROXY_CONFIG',
|
||||
'DEFAULT_GLOBAL_ENV',
|
||||
'DEFAULT_IMAGE_ANALYSIS_CONFIG',
|
||||
] as const;
|
||||
|
||||
for (const name of expectedRuntimeExports) {
|
||||
it(`barrel exports "${name}"`, () => {
|
||||
expect(name in barrel).toBe(true);
|
||||
});
|
||||
}
|
||||
});
|
||||
@@ -0,0 +1,109 @@
|
||||
/**
|
||||
* Account, profile, and authentication config types.
|
||||
*
|
||||
* Covers:
|
||||
* - AccountConfig: isolated Claude instances via CLAUDE_CONFIG_DIR
|
||||
* - ProfileConfig: API-based profiles (env var injection)
|
||||
* - OAuthAccounts: CLIProxy nickname-to-email mapping
|
||||
* - CLIProxyAuthConfig: API key and management secret customization
|
||||
* - TokenRefreshSettings: background token refresh worker config
|
||||
* - DashboardAuthConfig: dashboard login protection
|
||||
*/
|
||||
|
||||
import type { TargetType } from '../../targets/target-adapter';
|
||||
|
||||
/**
|
||||
* Account configuration (formerly in profiles.json).
|
||||
* Represents an isolated Claude instance via CLAUDE_CONFIG_DIR.
|
||||
*/
|
||||
export interface AccountConfig {
|
||||
/** ISO timestamp when account was created */
|
||||
created: string;
|
||||
/** ISO timestamp of last usage, null if never used */
|
||||
last_used: string | null;
|
||||
/** Context mode for project workspace data */
|
||||
context_mode?: 'isolated' | 'shared';
|
||||
/** Context-sharing group when context_mode='shared' */
|
||||
context_group?: string;
|
||||
/** Shared continuity depth when context_mode='shared' */
|
||||
continuity_mode?: 'standard' | 'deeper';
|
||||
/** Bare profile: no shared symlinks (commands, skills, agents, settings.json) */
|
||||
bare?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* API-based profile configuration.
|
||||
* Injects environment variables for alternative providers (GLM, Kimi, etc.).
|
||||
*
|
||||
* Settings are stored in separate *.settings.json files (matching Claude's pattern)
|
||||
* to allow users to edit them directly without touching config.yaml.
|
||||
*/
|
||||
export interface ProfileConfig {
|
||||
/** Profile type - currently only 'api' */
|
||||
type: 'api';
|
||||
/** Path to settings file (e.g., "~/.ccs/glm.settings.json") */
|
||||
settings: string;
|
||||
/** Target CLI to use for this profile (default: 'claude') */
|
||||
target?: TargetType;
|
||||
}
|
||||
|
||||
/**
|
||||
* CLIProxy OAuth account nickname mapping.
|
||||
* Maps user-friendly nicknames to email addresses.
|
||||
*/
|
||||
export type OAuthAccounts = Record<string, string>;
|
||||
|
||||
/**
|
||||
* CLIProxy authentication configuration.
|
||||
* Allows customization of API key and management secret for CLIProxyAPI.
|
||||
*/
|
||||
export interface CLIProxyAuthConfig {
|
||||
/** API key for CCS-managed requests (default: 'ccs-internal-managed') */
|
||||
api_key?: string;
|
||||
/** Management secret for Control Panel login (default: 'ccs') */
|
||||
management_secret?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Token refresh configuration.
|
||||
* Manages background token refresh worker settings.
|
||||
*/
|
||||
export interface TokenRefreshSettings {
|
||||
/** Enable background token refresh (default: false) */
|
||||
enabled?: boolean;
|
||||
/** Refresh check interval in minutes (default: 30) */
|
||||
interval_minutes?: number;
|
||||
/** Preemptive refresh time in minutes (default: 45) */
|
||||
preemptive_minutes?: number;
|
||||
/** Maximum retry attempts per token (default: 3) */
|
||||
max_retries?: number;
|
||||
/** Enable verbose logging (default: false) */
|
||||
verbose?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Dashboard authentication configuration.
|
||||
* Optional login protection for CCS dashboard.
|
||||
* Disabled by default for backward compatibility.
|
||||
*/
|
||||
export interface DashboardAuthConfig {
|
||||
/** Enable dashboard authentication (default: false) */
|
||||
enabled: boolean;
|
||||
/** Username for dashboard login */
|
||||
username: string;
|
||||
/** Bcrypt-hashed password (use: npx bcrypt-cli hash 'password') */
|
||||
password_hash: string;
|
||||
/** Session timeout in hours (default: 24) */
|
||||
session_timeout_hours?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default dashboard auth configuration.
|
||||
* Disabled by default - must be explicitly enabled.
|
||||
*/
|
||||
export const DEFAULT_DASHBOARD_AUTH_CONFIG: DashboardAuthConfig = {
|
||||
enabled: false,
|
||||
username: '',
|
||||
password_hash: '',
|
||||
session_timeout_hours: 24,
|
||||
};
|
||||
@@ -0,0 +1,71 @@
|
||||
/**
|
||||
* Browser automation configuration types and defaults.
|
||||
*
|
||||
* Controls Claude browser attach and Codex browser tooling.
|
||||
* Version 13+ feature.
|
||||
*/
|
||||
|
||||
/**
|
||||
* Browser tool exposure policy.
|
||||
*/
|
||||
export type BrowserToolPolicy = 'auto' | 'manual';
|
||||
|
||||
/**
|
||||
* Browser eval access mode.
|
||||
*/
|
||||
export type BrowserEvalMode = 'disabled' | 'readonly' | 'readwrite';
|
||||
|
||||
/**
|
||||
* Claude browser attach configuration.
|
||||
*/
|
||||
export interface BrowserClaudeConfig {
|
||||
/** Enable Claude browser attach (default: false) */
|
||||
enabled: boolean;
|
||||
/** Control whether Claude browser attach is exposed automatically or only via --browser */
|
||||
policy: BrowserToolPolicy;
|
||||
/** Chrome user-data directory used for attach mode */
|
||||
user_data_dir: string;
|
||||
/** DevTools port used for attach mode (default: 9222) */
|
||||
devtools_port: number;
|
||||
/** Eval access mode exposed through browser settings/status surfaces */
|
||||
eval_mode?: BrowserEvalMode;
|
||||
}
|
||||
|
||||
/**
|
||||
* Codex browser tooling configuration.
|
||||
*/
|
||||
export interface BrowserCodexConfig {
|
||||
/** Enable Codex browser tooling injection (default: false) */
|
||||
enabled: boolean;
|
||||
/** Control whether Codex browser tooling is exposed automatically or only via --browser */
|
||||
policy: BrowserToolPolicy;
|
||||
/** Eval access mode exposed through browser settings/status surfaces */
|
||||
eval_mode?: BrowserEvalMode;
|
||||
}
|
||||
|
||||
/**
|
||||
* Browser automation configuration.
|
||||
* Controls Claude browser attach and Codex browser tooling.
|
||||
*/
|
||||
export interface BrowserConfig {
|
||||
claude: BrowserClaudeConfig;
|
||||
codex: BrowserCodexConfig;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default browser configuration.
|
||||
*/
|
||||
export const DEFAULT_BROWSER_CONFIG: BrowserConfig = {
|
||||
claude: {
|
||||
enabled: false,
|
||||
policy: 'manual',
|
||||
user_data_dir: '',
|
||||
devtools_port: 9222,
|
||||
eval_mode: 'readonly',
|
||||
},
|
||||
codex: {
|
||||
enabled: false,
|
||||
policy: 'manual',
|
||||
eval_mode: 'readonly',
|
||||
},
|
||||
};
|
||||
@@ -0,0 +1,32 @@
|
||||
/**
|
||||
* Official Channels configuration types and defaults.
|
||||
*
|
||||
* Controls runtime-only injection of Anthropic's official channel plugins
|
||||
* (Telegram, Discord, iMessage).
|
||||
* Version 12+ feature.
|
||||
*/
|
||||
|
||||
/**
|
||||
* Supported Anthropic official channel IDs.
|
||||
*/
|
||||
export type OfficialChannelId = 'telegram' | 'discord' | 'imessage';
|
||||
|
||||
/**
|
||||
* Official Channels configuration.
|
||||
* Controls runtime-only injection of Anthropic's official channel plugins.
|
||||
*/
|
||||
export interface OfficialChannelsConfig {
|
||||
/** Selected official channels to auto-enable for compatible sessions */
|
||||
selected: OfficialChannelId[];
|
||||
/** Also add --dangerously-skip-permissions when auto-enable is active */
|
||||
unattended: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default Official Channels configuration.
|
||||
* Disabled by default because the feature requires explicit user setup.
|
||||
*/
|
||||
export const DEFAULT_OFFICIAL_CHANNELS_CONFIG: OfficialChannelsConfig = {
|
||||
selected: [],
|
||||
unattended: false,
|
||||
};
|
||||
@@ -0,0 +1,151 @@
|
||||
/**
|
||||
* CLIProxy configuration types and defaults.
|
||||
*
|
||||
* Covers provider/variant/routing/safety/logging configuration
|
||||
* for the CLIProxy integration layer.
|
||||
*/
|
||||
|
||||
import type { TargetType } from '../../targets/target-adapter';
|
||||
import type { CLIProxyProvider, CliproxyRoutingStrategy } from '../../cliproxy/types';
|
||||
import { CLIPROXY_PROVIDER_IDS } from '../../cliproxy/provider-capabilities';
|
||||
import type { OAuthAccounts, CLIProxyAuthConfig, TokenRefreshSettings } from './auth';
|
||||
|
||||
/**
|
||||
* Supported CLIProxy providers.
|
||||
* Derived from CLIPROXY_PROVIDER_IDS — single source of truth in provider-capabilities.ts.
|
||||
*/
|
||||
export { CLIPROXY_PROVIDER_IDS as CLIPROXY_SUPPORTED_PROVIDERS };
|
||||
|
||||
/**
|
||||
* CLIProxy variant configuration.
|
||||
* User-defined variants of built-in OAuth providers.
|
||||
*
|
||||
* Settings are stored in separate *.settings.json files (matching Claude's pattern)
|
||||
* to allow users to edit them directly without touching config.yaml.
|
||||
*/
|
||||
export interface CLIProxyVariantConfig {
|
||||
/** Base provider to use */
|
||||
provider: CLIProxyProvider;
|
||||
/** Account nickname (references oauth_accounts) */
|
||||
account?: string;
|
||||
/** Path to settings file (e.g., "~/.ccs/gemini-custom.settings.json") */
|
||||
settings?: string;
|
||||
/** Unique port for variant isolation (8318-8417) */
|
||||
port?: number;
|
||||
/** Per-variant auth override (optional) */
|
||||
auth?: CLIProxyAuthConfig;
|
||||
/** Target CLI to use for this variant (default: 'claude') */
|
||||
target?: TargetType;
|
||||
}
|
||||
|
||||
/**
|
||||
* Per-tier provider+model mapping for composite variants.
|
||||
*/
|
||||
export interface CompositeTierConfig {
|
||||
/** Provider for this tier */
|
||||
provider: CLIProxyProvider;
|
||||
/** Model ID to use for this tier */
|
||||
model: string;
|
||||
/** Account nickname (optional, references oauth_accounts) */
|
||||
account?: string;
|
||||
/** Fallback provider+model if primary fails */
|
||||
fallback?: {
|
||||
provider: CLIProxyProvider;
|
||||
model: string;
|
||||
account?: string;
|
||||
};
|
||||
/** Per-tier thinking budget override (e.g. 'xhigh', 'medium', 'off') */
|
||||
thinking?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Composite variant configuration.
|
||||
* Mixes different providers per Claude tier (opus, sonnet, haiku) in a single profile.
|
||||
* Uses CLIProxyAPI root endpoints (/v1/messages) for model-based routing
|
||||
* instead of provider-specific endpoints (/api/provider/{provider}).
|
||||
*/
|
||||
export interface CompositeVariantConfig {
|
||||
/** Discriminator for composite type */
|
||||
type: 'composite';
|
||||
/** Which tier ANTHROPIC_MODEL equals (default must be one of the three) */
|
||||
default_tier: 'opus' | 'sonnet' | 'haiku';
|
||||
/** Per-tier provider+model mapping */
|
||||
tiers: {
|
||||
opus: CompositeTierConfig;
|
||||
sonnet: CompositeTierConfig;
|
||||
haiku: CompositeTierConfig;
|
||||
};
|
||||
/** Path to settings file */
|
||||
settings?: string;
|
||||
/** Shared port for the composite profile */
|
||||
port?: number;
|
||||
/** Per-variant auth override (optional) */
|
||||
auth?: CLIProxyAuthConfig;
|
||||
/** Target CLI to use for this composite variant (default: 'claude') */
|
||||
target?: TargetType;
|
||||
}
|
||||
|
||||
/**
|
||||
* CLIProxy logging configuration.
|
||||
* Controls whether CLIProxyAPI writes logs to disk.
|
||||
* Logs can grow to several GB if left enabled.
|
||||
*/
|
||||
export interface CLIProxyLoggingConfig {
|
||||
/** Enable logging to file (default: false to prevent disk bloat) */
|
||||
enabled?: boolean;
|
||||
/** Enable request logging for debugging (default: false) */
|
||||
request_log?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* CLIProxy safety configuration.
|
||||
* Controls high-risk flow safeguards for supported providers.
|
||||
*/
|
||||
export interface CLIProxySafetyConfig {
|
||||
/** Allow skipping AGY responsibility checks and Gemini dashboard typed acknowledgement */
|
||||
antigravity_ack_bypass?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default CLIProxy safety configuration.
|
||||
*/
|
||||
export const DEFAULT_CLIPROXY_SAFETY_CONFIG: CLIProxySafetyConfig = {
|
||||
antigravity_ack_bypass: false,
|
||||
};
|
||||
|
||||
export interface CLIProxyRoutingConfig {
|
||||
/** Credential selection strategy when multiple accounts match */
|
||||
strategy?: CliproxyRoutingStrategy;
|
||||
/** Keep one conversation pinned to the same account when possible */
|
||||
session_affinity?: boolean;
|
||||
/** Go-style duration for session-affinity binding retention */
|
||||
session_affinity_ttl?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* CLIProxy configuration section.
|
||||
*/
|
||||
export interface CLIProxyConfig {
|
||||
/** Backend selection: 'original' or 'plus' (default: 'original') */
|
||||
backend?: 'original' | 'plus';
|
||||
/** Nickname to email mapping for OAuth accounts */
|
||||
oauth_accounts: OAuthAccounts;
|
||||
/** Built-in providers (read-only, for reference) */
|
||||
providers: readonly string[];
|
||||
/** User-defined provider variants (single-provider or composite) */
|
||||
variants: Record<string, CLIProxyVariantConfig | CompositeVariantConfig>;
|
||||
/** Logging configuration (disabled by default) */
|
||||
logging?: CLIProxyLoggingConfig;
|
||||
/** Safety controls for high-risk provider flows */
|
||||
safety?: CLIProxySafetyConfig;
|
||||
/** Kiro: disable incognito browser mode (use normal browser to save credentials) */
|
||||
kiro_no_incognito?: boolean;
|
||||
/** Global auth configuration for CLIProxyAPI */
|
||||
auth?: CLIProxyAuthConfig;
|
||||
/** Background token refresh worker settings */
|
||||
token_refresh?: TokenRefreshSettings;
|
||||
/** Auto-sync API profiles to local CLIProxy config on settings change (default: true) */
|
||||
auto_sync?: boolean;
|
||||
/** Routing strategy for multi-account CLIProxy selection */
|
||||
routing?: CLIProxyRoutingConfig;
|
||||
}
|
||||
@@ -0,0 +1,93 @@
|
||||
/**
|
||||
* Copilot and Cursor IDE integration configuration types and defaults.
|
||||
*
|
||||
* Covers:
|
||||
* - CopilotConfig: GitHub Copilot proxy integration (strictly opt-in)
|
||||
* - CursorConfig: Cursor IDE proxy daemon
|
||||
*/
|
||||
|
||||
/**
|
||||
* Copilot API account type.
|
||||
*/
|
||||
export type CopilotAccountType = 'individual' | 'business' | 'enterprise';
|
||||
|
||||
/**
|
||||
* Copilot API configuration.
|
||||
* Enables GitHub Copilot subscription usage via copilot-api proxy.
|
||||
* Strictly opt-in - disabled by default.
|
||||
*
|
||||
* !! DISCLAIMER - USE AT YOUR OWN RISK !!
|
||||
* This uses an UNOFFICIAL reverse-engineered API.
|
||||
* Excessive usage may trigger GitHub account restrictions.
|
||||
* CCS provides NO WARRANTY and accepts NO RESPONSIBILITY for any consequences.
|
||||
*/
|
||||
export interface CopilotConfig {
|
||||
/** Enable Copilot integration (default: false) - must be explicitly enabled */
|
||||
enabled: boolean;
|
||||
/** Auto-start copilot-api daemon when using profile (default: false) */
|
||||
auto_start: boolean;
|
||||
/** Port for copilot-api proxy (default: 4141) */
|
||||
port: number;
|
||||
/** GitHub Copilot account type (default: individual) */
|
||||
account_type: CopilotAccountType;
|
||||
/** Rate limit in seconds between requests (null = no limit) */
|
||||
rate_limit: number | null;
|
||||
/** Wait instead of error when rate limit is hit (default: true) */
|
||||
wait_on_limit: boolean;
|
||||
/** Default model ID (e.g., claude-sonnet-4.5) */
|
||||
model: string;
|
||||
/** Model mapping for Claude tiers - maps opus/sonnet/haiku to specific models */
|
||||
opus_model?: string;
|
||||
sonnet_model?: string;
|
||||
haiku_model?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Cursor IDE integration configuration.
|
||||
* Enables Cursor IDE usage via cursor proxy daemon.
|
||||
*/
|
||||
export interface CursorConfig {
|
||||
/** Enable Cursor integration (default: false) */
|
||||
enabled: boolean;
|
||||
/** Port for cursor proxy daemon (default: 20129) */
|
||||
port: number;
|
||||
/** Auto-start daemon when CCS starts (default: false) */
|
||||
auto_start: boolean;
|
||||
/** Enable ghost mode to disable telemetry (default: true) */
|
||||
ghost_mode: boolean;
|
||||
/** Default model ID used by Cursor integration */
|
||||
model: string;
|
||||
/** Optional tier mapping for Claude-compatible model routing */
|
||||
opus_model?: string;
|
||||
/** Optional tier mapping for Claude-compatible model routing */
|
||||
sonnet_model?: string;
|
||||
/** Optional tier mapping for Claude-compatible model routing */
|
||||
haiku_model?: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default Copilot configuration.
|
||||
* Strictly opt-in - disabled by default.
|
||||
* Uses gpt-4.1 as default model (free tier compatible).
|
||||
*/
|
||||
export const DEFAULT_COPILOT_CONFIG: CopilotConfig = {
|
||||
enabled: false,
|
||||
auto_start: false,
|
||||
port: 4141,
|
||||
account_type: 'individual',
|
||||
rate_limit: null,
|
||||
wait_on_limit: true,
|
||||
model: 'gpt-4.1',
|
||||
};
|
||||
|
||||
/**
|
||||
* Default Cursor configuration.
|
||||
* Disabled by default, ghost mode enabled for privacy.
|
||||
*/
|
||||
export const DEFAULT_CURSOR_CONFIG: CursorConfig = {
|
||||
enabled: false,
|
||||
port: 20129,
|
||||
auto_start: false,
|
||||
ghost_mode: true,
|
||||
model: 'gpt-5.3-codex',
|
||||
};
|
||||
@@ -0,0 +1,112 @@
|
||||
/**
|
||||
* Config schema barrel re-exports.
|
||||
*
|
||||
* All types, interfaces, constants, and functions originally in
|
||||
* unified-config-types.ts are re-exported here for backward compatibility.
|
||||
* Each module is responsible for a focused domain of the config schema.
|
||||
*/
|
||||
|
||||
// Version constant
|
||||
export { UNIFIED_CONFIG_VERSION } from './version';
|
||||
|
||||
// Account, profile, OAuth, auth types
|
||||
export type {
|
||||
AccountConfig,
|
||||
ProfileConfig,
|
||||
OAuthAccounts,
|
||||
CLIProxyAuthConfig,
|
||||
TokenRefreshSettings,
|
||||
DashboardAuthConfig,
|
||||
} from './auth';
|
||||
export { DEFAULT_DASHBOARD_AUTH_CONFIG } from './auth';
|
||||
|
||||
// CLIProxy provider, variant, routing, safety, logging types
|
||||
export { CLIPROXY_SUPPORTED_PROVIDERS, DEFAULT_CLIPROXY_SAFETY_CONFIG } from './cliproxy';
|
||||
export type {
|
||||
CLIProxyVariantConfig,
|
||||
CompositeTierConfig,
|
||||
CompositeVariantConfig,
|
||||
CLIProxyLoggingConfig,
|
||||
CLIProxySafetyConfig,
|
||||
CLIProxyRoutingConfig,
|
||||
CLIProxyConfig,
|
||||
} from './cliproxy';
|
||||
|
||||
// Quota management types and defaults
|
||||
export {
|
||||
DEFAULT_AUTO_QUOTA_CONFIG,
|
||||
DEFAULT_MANUAL_QUOTA_CONFIG,
|
||||
DEFAULT_RUNTIME_MONITOR_CONFIG,
|
||||
DEFAULT_QUOTA_MANAGEMENT_CONFIG,
|
||||
} from './quota';
|
||||
export type {
|
||||
AutoQuotaConfig,
|
||||
RuntimeMonitorConfig,
|
||||
ManualQuotaConfig,
|
||||
QuotaManagementMode,
|
||||
QuotaManagementConfig,
|
||||
} from './quota';
|
||||
|
||||
// Thinking/reasoning budget types and defaults
|
||||
export { DEFAULT_THINKING_TIER_DEFAULTS, DEFAULT_THINKING_CONFIG } from './thinking';
|
||||
export type { ThinkingMode, ThinkingTierDefaults, ThinkingConfig } from './thinking';
|
||||
|
||||
// Official channels types and defaults
|
||||
export { DEFAULT_OFFICIAL_CHANNELS_CONFIG } from './channels';
|
||||
export type { OfficialChannelId, OfficialChannelsConfig } from './channels';
|
||||
|
||||
// WebSearch backend types
|
||||
export type {
|
||||
DuckDuckGoWebSearchConfig,
|
||||
BraveWebSearchConfig,
|
||||
ExaWebSearchConfig,
|
||||
TavilyWebSearchConfig,
|
||||
SearxngWebSearchConfig,
|
||||
GeminiWebSearchConfig,
|
||||
GrokWebSearchConfig,
|
||||
OpenCodeWebSearchConfig,
|
||||
WebSearchProvidersConfig,
|
||||
WebSearchConfig,
|
||||
} from './websearch';
|
||||
|
||||
// Browser automation types and defaults
|
||||
export { DEFAULT_BROWSER_CONFIG } from './browser';
|
||||
export type {
|
||||
BrowserToolPolicy,
|
||||
BrowserEvalMode,
|
||||
BrowserClaudeConfig,
|
||||
BrowserCodexConfig,
|
||||
BrowserConfig,
|
||||
} from './browser';
|
||||
|
||||
// Logging and preferences types and defaults
|
||||
export { DEFAULT_LOGGING_CONFIG } from './logging';
|
||||
export type { LoggingLevel, LoggingConfig, PreferencesConfig } from './logging';
|
||||
|
||||
// Provider integration types and defaults
|
||||
export {
|
||||
DEFAULT_GLOBAL_ENV,
|
||||
DEFAULT_COPILOT_CONFIG,
|
||||
DEFAULT_CURSOR_CONFIG,
|
||||
DEFAULT_CLIPROXY_SERVER_CONFIG,
|
||||
DEFAULT_OPENAI_COMPAT_PROXY_CONFIG,
|
||||
DEFAULT_IMAGE_ANALYSIS_CONFIG,
|
||||
} from './providers';
|
||||
export type {
|
||||
CopilotAccountType,
|
||||
CopilotConfig,
|
||||
CursorConfig,
|
||||
ProxyRemoteConfig,
|
||||
ProxyFallbackConfig,
|
||||
ProxyLocalConfig,
|
||||
OpenAICompatProxyRoutingConfig,
|
||||
OpenAICompatProxyConfig,
|
||||
CliproxyServerConfig,
|
||||
GlobalEnvConfig,
|
||||
ContinuityConfig,
|
||||
ImageAnalysisConfig,
|
||||
} from './providers';
|
||||
|
||||
// Main unified config interface, factory, and type guard
|
||||
export { createEmptyUnifiedConfig, isUnifiedConfig } from './unified-config';
|
||||
export type { UnifiedConfig } from './unified-config';
|
||||
@@ -0,0 +1,53 @@
|
||||
/**
|
||||
* Logging and preferences configuration types and defaults.
|
||||
*
|
||||
* Covers:
|
||||
* - LoggingConfig: CCS-owned structured runtime logging
|
||||
* - LoggingLevel: log severity levels
|
||||
* - PreferencesConfig: user preferences (theme, telemetry, auto-update)
|
||||
*/
|
||||
|
||||
export type LoggingLevel = 'error' | 'warn' | 'info' | 'debug';
|
||||
|
||||
/**
|
||||
* CCS-owned structured logging configuration.
|
||||
* Separate from cliproxy.logging, which controls CLIProxy runtime files.
|
||||
*/
|
||||
export interface LoggingConfig {
|
||||
/** Enable CCS-owned structured runtime logging */
|
||||
enabled: boolean;
|
||||
/** Minimum level written to disk */
|
||||
level: LoggingLevel;
|
||||
/** Rotate current log when it reaches this size in MB */
|
||||
rotate_mb: number;
|
||||
/** Keep archived segments for this many days */
|
||||
retain_days: number;
|
||||
/** Redact sensitive values before persistence */
|
||||
redact: boolean;
|
||||
/** In-memory recent event buffer size for dashboard reads */
|
||||
live_buffer_size: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default logging configuration.
|
||||
*/
|
||||
export const DEFAULT_LOGGING_CONFIG: LoggingConfig = {
|
||||
enabled: true,
|
||||
level: 'info',
|
||||
rotate_mb: 10,
|
||||
retain_days: 7,
|
||||
redact: true,
|
||||
live_buffer_size: 250,
|
||||
};
|
||||
|
||||
/**
|
||||
* User preferences.
|
||||
*/
|
||||
export interface PreferencesConfig {
|
||||
/** UI theme preference */
|
||||
theme?: 'light' | 'dark' | 'system';
|
||||
/** Enable anonymous telemetry */
|
||||
telemetry?: boolean;
|
||||
/** Enable automatic update checks */
|
||||
auto_update?: boolean;
|
||||
}
|
||||
@@ -0,0 +1,30 @@
|
||||
/**
|
||||
* Provider integration configuration types and defaults.
|
||||
*
|
||||
* Re-exports from focused sub-modules for backward compatibility.
|
||||
* Actual definitions live in:
|
||||
* - copilot-cursor.ts: CopilotConfig, CursorConfig + defaults
|
||||
* - proxy-server.ts: CliproxyServerConfig, OpenAICompatProxyConfig,
|
||||
* GlobalEnvConfig, ContinuityConfig, ImageAnalysisConfig + defaults
|
||||
*/
|
||||
|
||||
export type { CopilotAccountType, CopilotConfig, CursorConfig } from './copilot-cursor';
|
||||
export { DEFAULT_COPILOT_CONFIG, DEFAULT_CURSOR_CONFIG } from './copilot-cursor';
|
||||
|
||||
export type {
|
||||
ProxyRemoteConfig,
|
||||
ProxyFallbackConfig,
|
||||
ProxyLocalConfig,
|
||||
OpenAICompatProxyRoutingConfig,
|
||||
OpenAICompatProxyConfig,
|
||||
CliproxyServerConfig,
|
||||
GlobalEnvConfig,
|
||||
ContinuityConfig,
|
||||
ImageAnalysisConfig,
|
||||
} from './proxy-server';
|
||||
export {
|
||||
DEFAULT_CLIPROXY_SERVER_CONFIG,
|
||||
DEFAULT_OPENAI_COMPAT_PROXY_CONFIG,
|
||||
DEFAULT_GLOBAL_ENV,
|
||||
DEFAULT_IMAGE_ANALYSIS_CONFIG,
|
||||
} from './proxy-server';
|
||||
@@ -0,0 +1,193 @@
|
||||
/**
|
||||
* Proxy server, global env, continuity, and image analysis types and defaults.
|
||||
*
|
||||
* Covers:
|
||||
* - CliproxyServerConfig: remote/local CLIProxy server mode
|
||||
* - OpenAICompatProxyConfig: OpenAI-compatible local proxy
|
||||
* - GlobalEnvConfig: global environment variable injection
|
||||
* - ContinuityConfig: cross-profile continuity inheritance
|
||||
* - ImageAnalysisConfig: vision analysis via CLIProxy
|
||||
*/
|
||||
|
||||
/**
|
||||
* Remote proxy configuration.
|
||||
* Connect to a remote CLIProxyAPI instance instead of spawning local binary.
|
||||
*/
|
||||
export interface ProxyRemoteConfig {
|
||||
/** Enable remote proxy mode (default: false = local mode) */
|
||||
enabled: boolean;
|
||||
/** Remote proxy hostname or IP (empty = not configured) */
|
||||
host: string;
|
||||
/**
|
||||
* Remote proxy port.
|
||||
* Optional - defaults based on protocol:
|
||||
* - HTTPS: 443
|
||||
* - HTTP: 8317
|
||||
* When empty/undefined, uses protocol default.
|
||||
*/
|
||||
port?: number;
|
||||
/** Protocol for remote connection */
|
||||
protocol: 'http' | 'https';
|
||||
/** Auth token for remote proxy API endpoints (optional, sent as header) */
|
||||
auth_token: string;
|
||||
/**
|
||||
* Management key for remote proxy management API endpoints.
|
||||
* CLIProxyAPI uses separate authentication for management endpoints
|
||||
* (/v0/management/*) via 'secret-key' config.
|
||||
* If not set, falls back to auth_token for backwards compatibility.
|
||||
*/
|
||||
management_key?: string;
|
||||
/** Connection timeout in milliseconds (default: 2000) */
|
||||
timeout?: number;
|
||||
/** Enable auto-sync profiles to remote on settings change (default: false) */
|
||||
auto_sync?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Fallback configuration when remote proxy is unreachable.
|
||||
*/
|
||||
export interface ProxyFallbackConfig {
|
||||
/** Enable fallback to local proxy (default: true) */
|
||||
enabled: boolean;
|
||||
/** Auto-start local proxy without prompting (default: false = prompt user) */
|
||||
auto_start: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Local proxy configuration.
|
||||
*/
|
||||
export interface ProxyLocalConfig {
|
||||
/** Local proxy port (default: 8317) */
|
||||
port: number;
|
||||
/** Auto-start local binary (default: true) */
|
||||
auto_start: boolean;
|
||||
}
|
||||
|
||||
export interface OpenAICompatProxyRoutingConfig {
|
||||
default?: string;
|
||||
background?: string;
|
||||
think?: string;
|
||||
longContext?: string;
|
||||
webSearch?: string;
|
||||
longContextThreshold?: number;
|
||||
}
|
||||
|
||||
export interface OpenAICompatProxyConfig {
|
||||
/** Default local port for OpenAI-compatible proxy instances */
|
||||
port?: number;
|
||||
/** Optional profile-scoped local port overrides */
|
||||
profile_ports?: Record<string, number>;
|
||||
routing?: OpenAICompatProxyRoutingConfig;
|
||||
}
|
||||
|
||||
/**
|
||||
* CLIProxy server configuration section.
|
||||
* Controls whether CCS uses local or remote CLIProxyAPI instance.
|
||||
*/
|
||||
export interface CliproxyServerConfig {
|
||||
/** Remote proxy settings */
|
||||
remote: ProxyRemoteConfig;
|
||||
/** Fallback behavior when remote is unreachable */
|
||||
fallback: ProxyFallbackConfig;
|
||||
/** Local proxy settings */
|
||||
local: ProxyLocalConfig;
|
||||
}
|
||||
|
||||
/**
|
||||
* Global environment variables configuration.
|
||||
* These env vars are injected into ALL non-Claude subscription profiles.
|
||||
* Useful for disabling telemetry, bug commands, error reporting, etc.
|
||||
*/
|
||||
export interface GlobalEnvConfig {
|
||||
/** Enable global env injection (default: true) */
|
||||
enabled: boolean;
|
||||
/** Environment variables to inject */
|
||||
env: Record<string, string>;
|
||||
}
|
||||
|
||||
/**
|
||||
* Cross-profile continuity inheritance configuration.
|
||||
* Maps execution profile names to source account profiles for CLAUDE_CONFIG_DIR reuse.
|
||||
*/
|
||||
export interface ContinuityConfig {
|
||||
/** Profile name -> source account profile name */
|
||||
inherit_from_account?: Record<string, string>;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default global env vars for third-party profiles.
|
||||
* These disable Claude Code telemetry/reporting since we're using proxy.
|
||||
*/
|
||||
export const DEFAULT_GLOBAL_ENV: Record<string, string> = {
|
||||
DISABLE_BUG_COMMAND: '1',
|
||||
DISABLE_ERROR_REPORTING: '1',
|
||||
DISABLE_TELEMETRY: '1',
|
||||
};
|
||||
|
||||
/**
|
||||
* Default CLIProxy server configuration.
|
||||
* Local mode by default - remote must be explicitly enabled.
|
||||
* Port is optional for remote - defaults based on protocol.
|
||||
*/
|
||||
export const DEFAULT_CLIPROXY_SERVER_CONFIG: CliproxyServerConfig = {
|
||||
remote: {
|
||||
enabled: false,
|
||||
host: '',
|
||||
protocol: 'http',
|
||||
auth_token: '',
|
||||
},
|
||||
fallback: {
|
||||
enabled: true,
|
||||
auto_start: false,
|
||||
},
|
||||
local: {
|
||||
port: 8317,
|
||||
auto_start: true,
|
||||
},
|
||||
};
|
||||
|
||||
export const DEFAULT_OPENAI_COMPAT_PROXY_CONFIG: OpenAICompatProxyConfig = {
|
||||
profile_ports: {},
|
||||
routing: {
|
||||
longContextThreshold: 60_000,
|
||||
},
|
||||
};
|
||||
|
||||
/**
|
||||
* Image analysis configuration.
|
||||
* Routes image/PDF files through CLIProxy for vision analysis.
|
||||
*/
|
||||
export interface ImageAnalysisConfig {
|
||||
/** Enable image analysis via CLIProxy (default: true) */
|
||||
enabled: boolean;
|
||||
/** Timeout in seconds (default: 60) */
|
||||
timeout: number;
|
||||
/** Provider-to-model mapping for vision analysis */
|
||||
provider_models: Record<string, string>;
|
||||
/** Fallback backend used when a profile does not resolve to a provider-specific backend */
|
||||
fallback_backend?: string;
|
||||
/** Explicit profile-name-to-backend overrides for settings/custom aliases */
|
||||
profile_backends?: Record<string, string>;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default image analysis configuration.
|
||||
* Enabled by default for CLIProxy providers with vision support.
|
||||
*/
|
||||
export const DEFAULT_IMAGE_ANALYSIS_CONFIG: ImageAnalysisConfig = {
|
||||
enabled: true,
|
||||
timeout: 60,
|
||||
provider_models: {
|
||||
agy: 'gemini-3-1-flash-preview',
|
||||
gemini: 'gemini-3-flash-preview',
|
||||
codex: 'gpt-5.1-codex-mini',
|
||||
kiro: 'kiro-claude-haiku-4-5',
|
||||
ghcp: 'claude-haiku-4.5',
|
||||
claude: 'claude-haiku-4.5-20251001',
|
||||
qwen: 'vision-model',
|
||||
iflow: 'qwen3-vl-plus',
|
||||
kimi: 'vision-model',
|
||||
},
|
||||
fallback_backend: 'gemini',
|
||||
profile_backends: {},
|
||||
};
|
||||
@@ -0,0 +1,121 @@
|
||||
/**
|
||||
* Quota management configuration types and defaults.
|
||||
*
|
||||
* Controls hybrid auto+manual account selection for multi-account setups.
|
||||
* Version 7+ feature.
|
||||
*/
|
||||
|
||||
// ============================================================================
|
||||
// QUOTA MANAGEMENT CONFIGURATION (v7+)
|
||||
// ============================================================================
|
||||
|
||||
/**
|
||||
* Auto quota management configuration.
|
||||
* Controls automatic failover behavior.
|
||||
*/
|
||||
export interface AutoQuotaConfig {
|
||||
/** Enable pre-flight quota check before requests (default: true) */
|
||||
preflight_check: boolean;
|
||||
/** Quota percentage below which account is "exhausted" (default: 5) */
|
||||
exhaustion_threshold: number;
|
||||
/** Tier priority for failover, highest to lowest (default: ['paid']) */
|
||||
tier_priority: string[];
|
||||
/** Minutes to skip exhausted account before retry (default: 5) */
|
||||
cooldown_minutes: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Runtime quota monitor configuration.
|
||||
* Controls adaptive polling during active sessions.
|
||||
*/
|
||||
export interface RuntimeMonitorConfig {
|
||||
/** Enable runtime monitoring during sessions (default: true) */
|
||||
enabled: boolean;
|
||||
/** Poll interval in seconds when quota > warn_threshold (default: 300) */
|
||||
normal_interval_seconds: number;
|
||||
/** Poll interval in seconds when quota <= warn_threshold (default: 60) */
|
||||
critical_interval_seconds: number;
|
||||
/** Quota percentage that triggers fast polling + warning (default: 20) */
|
||||
warn_threshold: number;
|
||||
/** Quota percentage that triggers cooldown + switch (default: 5) */
|
||||
exhaustion_threshold: number;
|
||||
/** Minutes to cooldown exhausted account (default: 5) */
|
||||
cooldown_minutes: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Manual quota management configuration.
|
||||
* User-controlled overrides for account selection.
|
||||
*/
|
||||
export interface ManualQuotaConfig {
|
||||
/** User-paused accounts (stored in accounts.json) */
|
||||
paused_accounts: string[];
|
||||
/** Force use of specific account (overrides auto-selection) */
|
||||
forced_default: string | null;
|
||||
/** Lock to specific tier only */
|
||||
tier_lock: string | null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Quota management mode.
|
||||
* - auto: Fully automatic failover based on quota
|
||||
* - manual: User controls everything, no auto-switching
|
||||
* - hybrid: Auto-failover with user overrides (default)
|
||||
*/
|
||||
export type QuotaManagementMode = 'auto' | 'manual' | 'hybrid';
|
||||
|
||||
/**
|
||||
* Quota management configuration section.
|
||||
* Controls hybrid auto+manual account selection for multi-account setups.
|
||||
*/
|
||||
export interface QuotaManagementConfig {
|
||||
/** Management mode (default: hybrid) */
|
||||
mode: QuotaManagementMode;
|
||||
/** Auto mode settings */
|
||||
auto: AutoQuotaConfig;
|
||||
/** Manual mode settings */
|
||||
manual: ManualQuotaConfig;
|
||||
/** Runtime monitor settings */
|
||||
runtime_monitor: RuntimeMonitorConfig;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default auto quota configuration.
|
||||
*/
|
||||
export const DEFAULT_AUTO_QUOTA_CONFIG: AutoQuotaConfig = {
|
||||
preflight_check: true,
|
||||
exhaustion_threshold: 5,
|
||||
tier_priority: ['ultra', 'pro', 'free'],
|
||||
cooldown_minutes: 5,
|
||||
};
|
||||
|
||||
/**
|
||||
* Default manual quota configuration.
|
||||
*/
|
||||
export const DEFAULT_MANUAL_QUOTA_CONFIG: ManualQuotaConfig = {
|
||||
paused_accounts: [],
|
||||
forced_default: null,
|
||||
tier_lock: null,
|
||||
};
|
||||
|
||||
/**
|
||||
* Default runtime monitor configuration.
|
||||
*/
|
||||
export const DEFAULT_RUNTIME_MONITOR_CONFIG: RuntimeMonitorConfig = {
|
||||
enabled: true,
|
||||
normal_interval_seconds: 300,
|
||||
critical_interval_seconds: 60,
|
||||
warn_threshold: 20,
|
||||
exhaustion_threshold: 5,
|
||||
cooldown_minutes: 5,
|
||||
};
|
||||
|
||||
/**
|
||||
* Default quota management configuration.
|
||||
*/
|
||||
export const DEFAULT_QUOTA_MANAGEMENT_CONFIG: QuotaManagementConfig = {
|
||||
mode: 'hybrid',
|
||||
auto: { ...DEFAULT_AUTO_QUOTA_CONFIG },
|
||||
manual: { ...DEFAULT_MANUAL_QUOTA_CONFIG },
|
||||
runtime_monitor: { ...DEFAULT_RUNTIME_MONITOR_CONFIG },
|
||||
};
|
||||
@@ -0,0 +1,66 @@
|
||||
/**
|
||||
* Thinking/reasoning budget configuration types and defaults.
|
||||
*
|
||||
* Controls thinking budget injection for CLIProxy providers.
|
||||
* Version 8+ feature.
|
||||
*/
|
||||
|
||||
// ============================================================================
|
||||
// THINKING CONFIGURATION (v8+)
|
||||
// ============================================================================
|
||||
|
||||
/**
|
||||
* Thinking mode for auto/manual/off control.
|
||||
* - auto: Apply tier-based defaults (opus→high, sonnet→medium, haiku→low)
|
||||
* - off: Disable thinking entirely
|
||||
* - manual: Use explicit override value
|
||||
*/
|
||||
export type ThinkingMode = 'auto' | 'off' | 'manual';
|
||||
|
||||
/**
|
||||
* Tier-to-thinking level defaults.
|
||||
* Maps Claude tier names to thinking level names.
|
||||
*/
|
||||
export interface ThinkingTierDefaults {
|
||||
/** Thinking level for opus tier (default: 'high') */
|
||||
opus: string;
|
||||
/** Thinking level for sonnet tier (default: 'medium') */
|
||||
sonnet: string;
|
||||
/** Thinking level for haiku tier (default: 'low') */
|
||||
haiku: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Thinking configuration section.
|
||||
* Controls thinking/reasoning budget injection for CLIProxy providers.
|
||||
*/
|
||||
export interface ThinkingConfig {
|
||||
/** Thinking mode (default: 'auto') */
|
||||
mode: ThinkingMode;
|
||||
/** Manual override value (level name or budget number) */
|
||||
override?: string | number;
|
||||
/** Tier-to-level mapping */
|
||||
tier_defaults: ThinkingTierDefaults;
|
||||
/** Per-provider overrides (e.g., { gemini: { opus: 'high' } }) */
|
||||
provider_overrides?: Record<string, Partial<ThinkingTierDefaults>>;
|
||||
/** Show warning when values are clamped (default: true) */
|
||||
show_warnings?: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Default thinking tier defaults.
|
||||
*/
|
||||
export const DEFAULT_THINKING_TIER_DEFAULTS: ThinkingTierDefaults = {
|
||||
opus: 'high',
|
||||
sonnet: 'medium',
|
||||
haiku: 'low',
|
||||
};
|
||||
|
||||
/**
|
||||
* Default thinking configuration.
|
||||
*/
|
||||
export const DEFAULT_THINKING_CONFIG: ThinkingConfig = {
|
||||
mode: 'auto',
|
||||
tier_defaults: { ...DEFAULT_THINKING_TIER_DEFAULTS },
|
||||
show_warnings: true,
|
||||
};
|
||||
@@ -0,0 +1,200 @@
|
||||
/**
|
||||
* Main unified configuration interface, factory, and type guard.
|
||||
*
|
||||
* The UnifiedConfig type is the root of the entire config.yaml schema.
|
||||
* This file imports all section types from their respective schema modules.
|
||||
*/
|
||||
|
||||
import type { AccountConfig, ProfileConfig, DashboardAuthConfig } from './auth';
|
||||
import { DEFAULT_DASHBOARD_AUTH_CONFIG } from './auth';
|
||||
import type { CLIProxyConfig } from './cliproxy';
|
||||
import { CLIPROXY_SUPPORTED_PROVIDERS, DEFAULT_CLIPROXY_SAFETY_CONFIG } from './cliproxy';
|
||||
import type { LoggingConfig, PreferencesConfig } from './logging';
|
||||
import { DEFAULT_LOGGING_CONFIG } from './logging';
|
||||
import type { WebSearchConfig } from './websearch';
|
||||
import type {
|
||||
GlobalEnvConfig,
|
||||
ContinuityConfig,
|
||||
CopilotConfig,
|
||||
CursorConfig,
|
||||
CliproxyServerConfig,
|
||||
OpenAICompatProxyConfig,
|
||||
ImageAnalysisConfig,
|
||||
} from './providers';
|
||||
import {
|
||||
DEFAULT_COPILOT_CONFIG,
|
||||
DEFAULT_CURSOR_CONFIG,
|
||||
DEFAULT_CLIPROXY_SERVER_CONFIG,
|
||||
DEFAULT_OPENAI_COMPAT_PROXY_CONFIG,
|
||||
DEFAULT_IMAGE_ANALYSIS_CONFIG,
|
||||
DEFAULT_GLOBAL_ENV,
|
||||
} from './providers';
|
||||
import { UNIFIED_CONFIG_VERSION } from './version';
|
||||
import type { QuotaManagementConfig } from './quota';
|
||||
import { DEFAULT_QUOTA_MANAGEMENT_CONFIG } from './quota';
|
||||
import type { ThinkingConfig } from './thinking';
|
||||
import { DEFAULT_THINKING_CONFIG } from './thinking';
|
||||
import type { OfficialChannelsConfig } from './channels';
|
||||
import { DEFAULT_OFFICIAL_CHANNELS_CONFIG } from './channels';
|
||||
import type { BrowserConfig } from './browser';
|
||||
import { DEFAULT_BROWSER_CONFIG } from './browser';
|
||||
|
||||
/**
|
||||
* Main unified configuration structure.
|
||||
* Stored in ~/.ccs/config.yaml
|
||||
*/
|
||||
export interface UnifiedConfig {
|
||||
/** Config version */
|
||||
version: number;
|
||||
/** Flag indicating setup wizard has been completed */
|
||||
setup_completed?: boolean;
|
||||
/** Default profile name to use when none specified */
|
||||
default?: string;
|
||||
/** Account-based profiles (isolated Claude instances) */
|
||||
accounts: Record<string, AccountConfig>;
|
||||
/** API-based profiles (env var injection) */
|
||||
profiles: Record<string, ProfileConfig>;
|
||||
/** CLIProxy configuration */
|
||||
cliproxy: CLIProxyConfig;
|
||||
/** OpenAI-compatible local proxy configuration */
|
||||
proxy?: OpenAICompatProxyConfig;
|
||||
/** CCS-owned structured logging configuration */
|
||||
logging?: LoggingConfig;
|
||||
/** User preferences */
|
||||
preferences: PreferencesConfig;
|
||||
/** WebSearch configuration */
|
||||
websearch?: WebSearchConfig;
|
||||
/** Global environment variables for all non-Claude subscription profiles */
|
||||
global_env?: GlobalEnvConfig;
|
||||
/** Cross-profile continuity inheritance mapping */
|
||||
continuity?: ContinuityConfig;
|
||||
/** Copilot API configuration (GitHub Copilot proxy) */
|
||||
copilot?: CopilotConfig;
|
||||
/** Cursor IDE configuration (Cursor proxy daemon) */
|
||||
cursor?: CursorConfig;
|
||||
/** CLIProxy server configuration for remote/local mode */
|
||||
cliproxy_server?: CliproxyServerConfig;
|
||||
/** Quota management configuration (v7+) */
|
||||
quota_management?: QuotaManagementConfig;
|
||||
/** Thinking/reasoning budget configuration (v8+) */
|
||||
thinking?: ThinkingConfig;
|
||||
/** Official Channels runtime auto-enable preferences (v11+) */
|
||||
channels?: OfficialChannelsConfig;
|
||||
/** Dashboard authentication configuration (optional) */
|
||||
dashboard_auth?: DashboardAuthConfig;
|
||||
/** Browser automation configuration */
|
||||
browser?: BrowserConfig;
|
||||
/** Image analysis configuration (vision via CLIProxy) */
|
||||
image_analysis?: ImageAnalysisConfig;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create an empty unified config with defaults.
|
||||
*/
|
||||
export function createEmptyUnifiedConfig(): UnifiedConfig {
|
||||
return {
|
||||
version: UNIFIED_CONFIG_VERSION,
|
||||
default: undefined,
|
||||
accounts: {},
|
||||
profiles: {},
|
||||
cliproxy: {
|
||||
backend: 'original',
|
||||
oauth_accounts: {},
|
||||
providers: [...CLIPROXY_SUPPORTED_PROVIDERS],
|
||||
variants: {},
|
||||
logging: {
|
||||
enabled: false,
|
||||
request_log: false,
|
||||
},
|
||||
safety: { ...DEFAULT_CLIPROXY_SAFETY_CONFIG },
|
||||
auto_sync: true,
|
||||
routing: {
|
||||
strategy: 'round-robin',
|
||||
session_affinity: false,
|
||||
session_affinity_ttl: '1h',
|
||||
},
|
||||
},
|
||||
proxy: {
|
||||
port: DEFAULT_OPENAI_COMPAT_PROXY_CONFIG.port,
|
||||
profile_ports: { ...DEFAULT_OPENAI_COMPAT_PROXY_CONFIG.profile_ports },
|
||||
routing: {
|
||||
...DEFAULT_OPENAI_COMPAT_PROXY_CONFIG.routing,
|
||||
},
|
||||
},
|
||||
logging: { ...DEFAULT_LOGGING_CONFIG },
|
||||
preferences: {
|
||||
theme: 'system',
|
||||
telemetry: false,
|
||||
auto_update: true,
|
||||
},
|
||||
websearch: {
|
||||
enabled: true,
|
||||
providers: {
|
||||
exa: {
|
||||
enabled: false,
|
||||
max_results: 5,
|
||||
},
|
||||
tavily: {
|
||||
enabled: false,
|
||||
max_results: 5,
|
||||
},
|
||||
brave: {
|
||||
enabled: false,
|
||||
max_results: 5,
|
||||
},
|
||||
searxng: {
|
||||
enabled: false,
|
||||
url: '',
|
||||
max_results: 5,
|
||||
},
|
||||
duckduckgo: {
|
||||
enabled: true,
|
||||
max_results: 5,
|
||||
},
|
||||
gemini: {
|
||||
enabled: false,
|
||||
model: 'gemini-2.5-flash',
|
||||
timeout: 55,
|
||||
},
|
||||
opencode: {
|
||||
enabled: false,
|
||||
model: 'opencode/grok-code',
|
||||
timeout: 90,
|
||||
},
|
||||
grok: {
|
||||
enabled: false,
|
||||
timeout: 55,
|
||||
},
|
||||
},
|
||||
},
|
||||
global_env: {
|
||||
enabled: true,
|
||||
env: { ...DEFAULT_GLOBAL_ENV },
|
||||
},
|
||||
copilot: { ...DEFAULT_COPILOT_CONFIG },
|
||||
cursor: { ...DEFAULT_CURSOR_CONFIG },
|
||||
cliproxy_server: { ...DEFAULT_CLIPROXY_SERVER_CONFIG },
|
||||
quota_management: { ...DEFAULT_QUOTA_MANAGEMENT_CONFIG },
|
||||
thinking: { ...DEFAULT_THINKING_CONFIG },
|
||||
channels: { ...DEFAULT_OFFICIAL_CHANNELS_CONFIG },
|
||||
dashboard_auth: { ...DEFAULT_DASHBOARD_AUTH_CONFIG },
|
||||
browser: {
|
||||
claude: { ...DEFAULT_BROWSER_CONFIG.claude },
|
||||
codex: { ...DEFAULT_BROWSER_CONFIG.codex },
|
||||
},
|
||||
image_analysis: { ...DEFAULT_IMAGE_ANALYSIS_CONFIG },
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Type guard for UnifiedConfig.
|
||||
* Relaxed validation: accepts configs with version >= 1 and any subset of sections.
|
||||
* Missing sections will be filled with defaults during merge.
|
||||
*/
|
||||
export function isUnifiedConfig(obj: unknown): obj is UnifiedConfig {
|
||||
if (typeof obj !== 'object' || obj === null) return false;
|
||||
const config = obj as Record<string, unknown>;
|
||||
// Only require version to be a number >= 1 (allow future versions)
|
||||
// Sections are optional - will be merged with defaults in loadOrCreateUnifiedConfig
|
||||
return typeof config.version === 'number' && config.version >= 1;
|
||||
}
|
||||
@@ -0,0 +1,23 @@
|
||||
/**
|
||||
* Unified config version constant.
|
||||
*
|
||||
* Central source of truth for the current config schema version.
|
||||
* Incremented whenever new sections are added to config.yaml.
|
||||
*/
|
||||
|
||||
/**
|
||||
* Unified config version.
|
||||
* Version 2 = YAML unified format
|
||||
* Version 3 = WebSearch config with model configuration for Gemini/OpenCode
|
||||
* Version 4 = Copilot API integration (GitHub Copilot proxy)
|
||||
* Version 5 = Remote proxy configuration (connect to remote CLIProxyAPI)
|
||||
* Version 6 = Customizable auth tokens (API key and management secret)
|
||||
* Version 7 = Quota management for hybrid auto+manual account control
|
||||
* Version 8 = Thinking/reasoning budget configuration
|
||||
* Version 9 = Real WebSearch backends (DuckDuckGo/Brave) with legacy CLI fallback
|
||||
* Version 10 = Exa + Tavily WebSearch backends
|
||||
* Version 11 = Discord Channels runtime auto-enable preferences
|
||||
* Version 12 = Official Channels multi-provider support (Telegram, Discord, iMessage)
|
||||
* Version 13 = Browser automation defaults to safe manual/off exposure
|
||||
*/
|
||||
export const UNIFIED_CONFIG_VERSION = 13;
|
||||
@@ -0,0 +1,148 @@
|
||||
/**
|
||||
* WebSearch backend configuration types.
|
||||
*
|
||||
* Covers all supported search backends:
|
||||
* - API-backed: Exa, Tavily, Brave
|
||||
* - Self-hosted: SearXNG
|
||||
* - Zero-setup: DuckDuckGo
|
||||
* - Legacy CLI fallbacks: Gemini, Grok, OpenCode
|
||||
*/
|
||||
|
||||
/**
|
||||
* DuckDuckGo WebSearch configuration.
|
||||
*/
|
||||
export interface DuckDuckGoWebSearchConfig {
|
||||
/** Enable DuckDuckGo HTML search fallback (default: true) */
|
||||
enabled?: boolean;
|
||||
/** Number of results to fetch (default: 5) */
|
||||
max_results?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Brave WebSearch configuration.
|
||||
*/
|
||||
export interface BraveWebSearchConfig {
|
||||
/** Enable Brave Search when BRAVE_API_KEY is available (default: false) */
|
||||
enabled?: boolean;
|
||||
/** Number of results to fetch (default: 5) */
|
||||
max_results?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Exa WebSearch configuration.
|
||||
*/
|
||||
export interface ExaWebSearchConfig {
|
||||
/** Enable Exa Search when EXA_API_KEY is available (default: false) */
|
||||
enabled?: boolean;
|
||||
/** Number of results to fetch (default: 5) */
|
||||
max_results?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Tavily WebSearch configuration.
|
||||
*/
|
||||
export interface TavilyWebSearchConfig {
|
||||
/** Enable Tavily Search when TAVILY_API_KEY is available (default: false) */
|
||||
enabled?: boolean;
|
||||
/** Number of results to fetch (default: 5) */
|
||||
max_results?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* SearXNG WebSearch configuration.
|
||||
*/
|
||||
export interface SearxngWebSearchConfig {
|
||||
/** Enable SearXNG JSON search backend (default: false) */
|
||||
enabled?: boolean;
|
||||
/** Base SearXNG URL, e.g. https://search.example.com (default: '') */
|
||||
url?: string;
|
||||
/** Number of results to fetch (default: 5) */
|
||||
max_results?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gemini CLI WebSearch configuration.
|
||||
*/
|
||||
export interface GeminiWebSearchConfig {
|
||||
/** Enable Gemini CLI legacy fallback (default: false) */
|
||||
enabled?: boolean;
|
||||
/** Model to use (default: gemini-2.5-flash) */
|
||||
model?: string;
|
||||
/** Timeout in seconds (default: 55) */
|
||||
timeout?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* Grok CLI WebSearch configuration.
|
||||
*/
|
||||
export interface GrokWebSearchConfig {
|
||||
/** Enable Grok CLI legacy fallback (default: false - requires GROK_API_KEY) */
|
||||
enabled?: boolean;
|
||||
/** Timeout in seconds (default: 55) */
|
||||
timeout?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* OpenCode CLI WebSearch configuration.
|
||||
*/
|
||||
export interface OpenCodeWebSearchConfig {
|
||||
/** Enable OpenCode CLI legacy fallback (default: false) */
|
||||
enabled?: boolean;
|
||||
/** Model to use (default: opencode/grok-code) */
|
||||
model?: string;
|
||||
/** Timeout in seconds (default: 60) */
|
||||
timeout?: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* WebSearch providers configuration.
|
||||
* Uses deterministic search backends first, with optional legacy CLI fallback.
|
||||
*/
|
||||
export interface WebSearchProvidersConfig {
|
||||
/** Exa Search API - API-backed search with strong relevance and content extraction */
|
||||
exa?: ExaWebSearchConfig;
|
||||
/** Tavily Search API - API-backed search optimized for agent/tool usage */
|
||||
tavily?: TavilyWebSearchConfig;
|
||||
/** Brave Search API - higher quality results when BRAVE_API_KEY is set */
|
||||
brave?: BraveWebSearchConfig;
|
||||
/** SearXNG JSON search - self-hosted or public instance backend */
|
||||
searxng?: SearxngWebSearchConfig;
|
||||
/** DuckDuckGo HTML search - zero setup default backend */
|
||||
duckduckgo?: DuckDuckGoWebSearchConfig;
|
||||
/** Gemini CLI - optional legacy LLM fallback */
|
||||
gemini?: GeminiWebSearchConfig;
|
||||
/** Grok CLI - optional legacy LLM fallback */
|
||||
grok?: GrokWebSearchConfig;
|
||||
/** OpenCode - optional legacy LLM fallback */
|
||||
opencode?: OpenCodeWebSearchConfig;
|
||||
}
|
||||
|
||||
/**
|
||||
* WebSearch configuration.
|
||||
* Uses deterministic local backends for third-party profiles.
|
||||
* Legacy AI CLI fallbacks remain available for compatibility only.
|
||||
*/
|
||||
export interface WebSearchConfig {
|
||||
/** Master switch - enable/disable WebSearch (default: true) */
|
||||
enabled?: boolean;
|
||||
/** Individual provider configurations */
|
||||
providers?: WebSearchProvidersConfig;
|
||||
// Legacy fields (deprecated, kept for backwards compatibility)
|
||||
/** @deprecated Use providers.gemini instead */
|
||||
gemini?: {
|
||||
enabled?: boolean;
|
||||
timeout?: number;
|
||||
};
|
||||
/** @deprecated Unused */
|
||||
mode?: 'sequential' | 'parallel';
|
||||
/** @deprecated Unused */
|
||||
provider?: 'auto' | 'web-search-prime' | 'brave' | 'tavily';
|
||||
/** @deprecated Unused */
|
||||
fallback?: boolean;
|
||||
/** @deprecated Unused */
|
||||
webSearchPrimeUrl?: string;
|
||||
/** @deprecated Unused */
|
||||
selectedProviders?: string[];
|
||||
/** @deprecated Unused */
|
||||
customMcp?: unknown[];
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
Reference in New Issue
Block a user