@girardmedia/bootspring 2.5.6 → 2.5.8

package/dist/core/index.d.ts

@@ -6,6 +6,66 @@ import { z } from 'zod';
  *
  * Manages authentication tokens stored in ~/.bootspring/
  */
+interface UserProfile {
+    id?: string;
+    email?: string;
+    name?: string;
+    tier?: string;
+    [key: string]: unknown;
+}
+interface Credentials {
+    token?: string;
+    refreshToken?: string;
+    apiKey?: string;
+    expiresAt?: string;
+    user?: UserProfile;
+}
+interface LoginResponse {
+    token: string;
+    refreshToken?: string;
+    expiresIn?: string;
+    user?: UserProfile;
+}
+interface DeviceInfo {
+    deviceId: string;
+    fingerprint: string;
+    createdAt: string;
+    platform: string;
+    arch: string;
+    hostname: string;
+}
+interface DeviceContext {
+    deviceId: string;
+    platform: string;
+    arch: string;
+    hostname: string;
+    cliVersion: string;
+    nodeVersion: string;
+    timezone: string;
+    cwd: string;
+    cwdFull: string;
+}
+interface ProjectAuth {
+    token: string;
+    expiresAt: string;
+    issuedAt: string;
+    source: string;
+    migratedFromLegacyApiKey: boolean;
+}
+interface ProjectConfig {
+    apiKey?: string;
+    projectAuth?: ProjectAuth;
+    [key: string]: unknown;
+}
+interface SessionOptions {
+    expiresAt?: string;
+    expiresIn?: number | string;
+    source?: string;
+    migratedFromLegacyApiKey?: boolean;
+}
+interface BootspringConfig {
+    [key: string]: unknown;
+}
 declare const BOOTSPRING_DIR: string;
 declare const CREDENTIALS_FILE: string;
 declare const CONFIG_FILE: string;
@@ -20,26 +80,25 @@ interface EncryptedData {
     v: number;
 }
 /**
- * Encrypt data
+ * Encrypt data — always uses v2 (scrypt) key derivation
  * @throws {Error} If encryption fails - never falls back to plaintext
  */
-declare function encrypt(data: any): EncryptedData;
+declare function encrypt(data: Credentials): EncryptedData;
 /**
- * Decrypt data
- * @throws {Error} If decryption fails - indicates corrupted or tampered credentials
+ * Decrypt data — tries v2 key first, falls back to v1 for migration
+ * @throws {Error} If decryption fails with both key versions
  */
-declare function decrypt(encrypted: any): any;
+declare function decrypt(encrypted: unknown): Credentials;
 /**
  * Get stored credentials
- * @returns {object|null} Decrypted credentials or null if not available
+ * @returns Decrypted credentials or null if not available
  */
-declare function getCredentials(): any | null;
+declare function getCredentials(): Credentials | null;
 /**
- * Save credentials (encrypted)
- * @param {object} credentials - Credentials to save
+ * Save credentials (encrypted with v2 scrypt key)
  * @throws {Error} If encryption or file write fails
  */
-declare function saveCredentials(credentials: any): void;
+declare function saveCredentials(credentials: Credentials): void;
 /**
  * Clear credentials (logout)
  */
@@ -61,10 +120,10 @@ declare function getTokenExpiryStatus(thresholdMs?: number): ExpiryStatus;
 declare function findNearestProjectConfigPath(): string | null;
 declare function readNearestProjectConfig(): {
     path: string;
-    config: any;
+    config: ProjectConfig;
 } | null;
-declare function writeNearestProjectConfig(configPath: string, config: any): boolean;
-declare function getProjectScopedSessionState(): any | null;
+declare function writeNearestProjectConfig(configPath: string, config: ProjectConfig): boolean;
+declare function getProjectScopedSessionState(): ProjectAuth | null;
 declare function getLegacyProjectApiKey(): string | null;
 declare function getProjectScopedToken(): string | null;
 declare function getStoredApiKey(): string | null;
@@ -72,30 +131,39 @@ declare function getApiKey(): string | null;
 declare function isApiKeyAuth(): boolean;
 declare function getRefreshToken(): string | null;
 declare function isAuthenticated(): boolean;
-declare function getUser(): any | null;
+declare function getUser(): UserProfile | null;
 declare function getTier$1(): string;
-declare function login(response: any): void;
+declare function login(response: LoginResponse): void;
 declare function saveApiKeyToProject(apiKey: string): boolean;
 declare function clearProjectApiKey(): boolean;
-declare function loginWithApiKey(apiKey: string, user: any): void;
-declare function updateTokens(response: any): void;
-declare function saveProjectScopedSession(token: string, options?: any): boolean;
+declare function loginWithApiKey(apiKey: string, user?: UserProfile): void;
+declare function updateTokens(response: LoginResponse): void;
+declare function saveProjectScopedSession(token: string, options?: SessionOptions): boolean;
 declare function clearProjectScopedSession(): boolean;
 declare function logout(): void;
-declare function getConfig(): any;
-declare function saveConfig(config: any): void;
+declare function getConfig(): BootspringConfig;
+declare function saveConfig(config: BootspringConfig): void;
 declare function getCredentialsPath(): string;
 declare function generateDeviceFingerprint(): string;
-declare function getDeviceInfo(): any;
+declare function getDeviceInfo(): DeviceInfo;
 declare function getDeviceId(): string;
-declare function getDeviceContext(cliVersion?: string): any;
+declare function getDeviceContext(cliVersion?: string): DeviceContext;
 declare function clearDeviceInfo(): void;
 
 declare const auth_BOOTSPRING_DIR: typeof BOOTSPRING_DIR;
+type auth_BootspringConfig = BootspringConfig;
 declare const auth_CONFIG_FILE: typeof CONFIG_FILE;
 declare const auth_CREDENTIALS_FILE: typeof CREDENTIALS_FILE;
+type auth_Credentials = Credentials;
 declare const auth_DEVICE_FILE: typeof DEVICE_FILE;
+type auth_DeviceContext = DeviceContext;
+type auth_DeviceInfo = DeviceInfo;
 type auth_ExpiryStatus = ExpiryStatus;
+type auth_LoginResponse = LoginResponse;
+type auth_ProjectAuth = ProjectAuth;
+type auth_ProjectConfig = ProjectConfig;
+type auth_SessionOptions = SessionOptions;
+type auth_UserProfile = UserProfile;
 declare const auth_clearCredentials: typeof clearCredentials;
 declare const auth_clearDeviceInfo: typeof clearDeviceInfo;
 declare const auth_clearProjectApiKey: typeof clearProjectApiKey;
@@ -133,7 +201,7 @@ declare const auth_saveProjectScopedSession: typeof saveProjectScopedSession;
 declare const auth_updateTokens: typeof updateTokens;
 declare const auth_writeNearestProjectConfig: typeof writeNearestProjectConfig;
 declare namespace auth {
-  export { auth_BOOTSPRING_DIR as BOOTSPRING_DIR, auth_CONFIG_FILE as CONFIG_FILE, auth_CREDENTIALS_FILE as CREDENTIALS_FILE, auth_DEVICE_FILE as DEVICE_FILE, type auth_ExpiryStatus as ExpiryStatus, auth_clearCredentials as clearCredentials, auth_clearDeviceInfo as clearDeviceInfo, auth_clearProjectApiKey as clearProjectApiKey, auth_clearProjectScopedSession as clearProjectScopedSession, auth_decrypt as decrypt, auth_encrypt as encrypt, auth_ensureBootspringDir as ensureBootspringDir, auth_findNearestProjectConfigPath as findNearestProjectConfigPath, auth_generateDeviceFingerprint as generateDeviceFingerprint, auth_getApiKey as getApiKey, auth_getConfig as getConfig, auth_getCredentials as getCredentials, auth_getCredentialsPath as getCredentialsPath, auth_getDeviceContext as getDeviceContext, auth_getDeviceId as getDeviceId, auth_getDeviceInfo as getDeviceInfo, auth_getLegacyProjectApiKey as getLegacyProjectApiKey, auth_getProjectScopedSessionState as getProjectScopedSessionState, auth_getProjectScopedToken as getProjectScopedToken, auth_getRefreshToken as getRefreshToken, auth_getStoredApiKey as getStoredApiKey, getTier$1 as getTier, auth_getToken as getToken, auth_getTokenExpiryStatus as getTokenExpiryStatus, auth_getUser as getUser, auth_isApiKeyAuth as isApiKeyAuth, auth_isAuthenticated as isAuthenticated, auth_login as login, auth_loginWithApiKey as loginWithApiKey, auth_logout as logout, auth_readNearestProjectConfig as readNearestProjectConfig, auth_saveApiKeyToProject as saveApiKeyToProject, auth_saveConfig as saveConfig, auth_saveCredentials as saveCredentials, auth_saveProjectScopedSession as saveProjectScopedSession, auth_updateTokens as updateTokens, auth_writeNearestProjectConfig as writeNearestProjectConfig };
+  export { auth_BOOTSPRING_DIR as BOOTSPRING_DIR, type auth_BootspringConfig as BootspringConfig, auth_CONFIG_FILE as CONFIG_FILE, auth_CREDENTIALS_FILE as CREDENTIALS_FILE, type auth_Credentials as Credentials, auth_DEVICE_FILE as DEVICE_FILE, type auth_DeviceContext as DeviceContext, type auth_DeviceInfo as DeviceInfo, type auth_ExpiryStatus as ExpiryStatus, type auth_LoginResponse as LoginResponse, type auth_ProjectAuth as ProjectAuth, type auth_ProjectConfig as ProjectConfig, type auth_SessionOptions as SessionOptions, type auth_UserProfile as UserProfile, auth_clearCredentials as clearCredentials, auth_clearDeviceInfo as clearDeviceInfo, auth_clearProjectApiKey as clearProjectApiKey, auth_clearProjectScopedSession as clearProjectScopedSession, auth_decrypt as decrypt, auth_encrypt as encrypt, auth_ensureBootspringDir as ensureBootspringDir, auth_findNearestProjectConfigPath as findNearestProjectConfigPath, auth_generateDeviceFingerprint as generateDeviceFingerprint, auth_getApiKey as getApiKey, auth_getConfig as getConfig, auth_getCredentials as getCredentials, auth_getCredentialsPath as getCredentialsPath, auth_getDeviceContext as getDeviceContext, auth_getDeviceId as getDeviceId, auth_getDeviceInfo as getDeviceInfo, auth_getLegacyProjectApiKey as getLegacyProjectApiKey, auth_getProjectScopedSessionState as getProjectScopedSessionState, auth_getProjectScopedToken as getProjectScopedToken, auth_getRefreshToken as getRefreshToken, auth_getStoredApiKey as getStoredApiKey, getTier$1 as getTier, auth_getToken as getToken, auth_getTokenExpiryStatus as getTokenExpiryStatus, auth_getUser as getUser, auth_isApiKeyAuth as isApiKeyAuth, auth_isAuthenticated as isAuthenticated, auth_login as login, auth_loginWithApiKey as loginWithApiKey, auth_logout as logout, auth_readNearestProjectConfig as readNearestProjectConfig, auth_saveApiKeyToProject as saveApiKeyToProject, auth_saveConfig as saveConfig, auth_saveCredentials as saveCredentials, auth_saveProjectScopedSession as saveProjectScopedSession, auth_updateTokens as updateTokens, auth_writeNearestProjectConfig as writeNearestProjectConfig };
 }
 
 /**
@@ -150,17 +218,29 @@ declare function healthCheck(): Promise<any>;
 declare function apiLogin(email: string, password: string): Promise<any>;
 declare function startDeviceFlow(): Promise<any>;
 declare function pollDeviceToken(deviceCode: string): Promise<any>;
+declare function refreshSession(): Promise<any>;
+declare function remoteLogout(): Promise<any>;
+declare function listMcpTools(): Promise<any>;
+declare function callMcpTool(tool: string, args: unknown): Promise<any>;
+declare function listMcpResources(): Promise<any>;
+declare function getMcpResource(uri: string): Promise<any>;
 
 declare const apiClient_API_BASE: typeof API_BASE;
 declare const apiClient_API_VERSION: typeof API_VERSION;
 declare const apiClient_apiLogin: typeof apiLogin;
+declare const apiClient_callMcpTool: typeof callMcpTool;
+declare const apiClient_getMcpResource: typeof getMcpResource;
 declare const apiClient_healthCheck: typeof healthCheck;
+declare const apiClient_listMcpResources: typeof listMcpResources;
+declare const apiClient_listMcpTools: typeof listMcpTools;
 declare const apiClient_pollDeviceToken: typeof pollDeviceToken;
+declare const apiClient_refreshSession: typeof refreshSession;
+declare const apiClient_remoteLogout: typeof remoteLogout;
 declare const apiClient_request: typeof request;
 declare const apiClient_setAuthFailureHandler: typeof setAuthFailureHandler;
 declare const apiClient_startDeviceFlow: typeof startDeviceFlow;
 declare namespace apiClient {
-  export { apiClient_API_BASE as API_BASE, apiClient_API_VERSION as API_VERSION, apiClient_apiLogin as apiLogin, apiClient_healthCheck as healthCheck, apiClient_pollDeviceToken as pollDeviceToken, apiClient_request as request, apiClient_setAuthFailureHandler as setAuthFailureHandler, apiClient_startDeviceFlow as startDeviceFlow };
+  export { apiClient_API_BASE as API_BASE, apiClient_API_VERSION as API_VERSION, apiClient_apiLogin as apiLogin, apiClient_callMcpTool as callMcpTool, apiClient_getMcpResource as getMcpResource, apiClient_healthCheck as healthCheck, apiClient_listMcpResources as listMcpResources, apiClient_listMcpTools as listMcpTools, apiClient_pollDeviceToken as pollDeviceToken, apiClient_refreshSession as refreshSession, apiClient_remoteLogout as remoteLogout, apiClient_request as request, apiClient_setAuthFailureHandler as setAuthFailureHandler, apiClient_startDeviceFlow as startDeviceFlow };
 }
 
 /**
@@ -390,7 +470,7 @@ interface InstallContext {
     scriptPath: string;
 }
 declare const PACKAGE_NAME = "@girardmedia/bootspring";
-declare const CURRENT_VERSION = "2.5.3";
+declare const CURRENT_VERSION = "2.5.7";
 declare const DEFAULT_INTERVAL_MS: number;
 declare const STATE_PATH: string;
 declare function compareVersions(a: string, b: string): number;
@@ -730,24 +810,20 @@ declare namespace entitlements {
 }
 
 /**
- * Bootspring Configuration
- * Handles loading and validating bootspring.config.js
+ * Bootspring Configuration — Zod Schemas & Types
+ *
+ * All Zod schema definitions and their inferred TypeScript types.
+ * Imported by config.ts and config-presets.ts.
  *
  * @package bootspring
- * @module core/config
+ * @module core/config-schemas
  */
 
-/**
- * Base plugin schema - all plugins share these common fields
- */
 declare const BasePluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodString>;
     features: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
 }, z.core.$loose>;
-/**
- * Auth plugin schema with specific provider options
- */
 declare const AuthPluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodEnum<{
@@ -768,9 +844,6 @@ declare const AuthPluginSchema: z.ZodObject<{
         passwordless: "passwordless";
     }>>>>;
 }, z.core.$loose>;
-/**
- * Payments plugin schema
- */
 declare const PaymentsPluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodEnum<{
@@ -789,9 +862,6 @@ declare const PaymentsPluginSchema: z.ZodObject<{
         coupons: "coupons";
     }>>>>;
 }, z.core.$loose>;
-/**
- * Database plugin schema
- */
 declare const DatabasePluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodEnum<{
@@ -810,9 +880,6 @@ declare const DatabasePluginSchema: z.ZodObject<{
         soft_delete: "soft_delete";
     }>>>>;
 }, z.core.$loose>;
-/**
- * Testing plugin schema
- */
 declare const TestingPluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodEnum<{
@@ -831,9 +898,6 @@ declare const TestingPluginSchema: z.ZodObject<{
         mocking: "mocking";
     }>>>>;
 }, z.core.$loose>;
-/**
- * Security plugin schema
- */
 declare const SecurityPluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodString>;
@@ -849,9 +913,6 @@ declare const SecurityPluginSchema: z.ZodObject<{
         secrets_management: "secrets_management";
     }>>>>;
 }, z.core.$loose>;
-/**
- * AI plugin schema
- */
 declare const AIPluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodEnum<{
@@ -870,9 +931,6 @@ declare const AIPluginSchema: z.ZodObject<{
         vision: "vision";
     }>>>>;
 }, z.core.$loose>;
-/**
- * Email plugin schema
- */
 declare const EmailPluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodEnum<{
@@ -890,9 +948,6 @@ declare const EmailPluginSchema: z.ZodObject<{
         tracking: "tracking";
     }>>>>;
 }, z.core.$loose>;
-/**
- * Analytics plugin schema
- */
 declare const AnalyticsPluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodEnum<{
@@ -910,9 +965,6 @@ declare const AnalyticsPluginSchema: z.ZodObject<{
         experiments: "experiments";
     }>>>>;
 }, z.core.$loose>;
-/**
- * Monitoring plugin schema
- */
 declare const MonitoringPluginSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     provider: z.ZodOptional<z.ZodEnum<{
@@ -930,9 +982,6 @@ declare const MonitoringPluginSchema: z.ZodObject<{
         apm: "apm";
     }>>>>;
 }, z.core.$loose>;
-/**
- * Combined plugins schema with specific plugin types
- */
 declare const PluginsSchema: z.ZodObject<{
     auth: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -1102,9 +1151,6 @@ declare const PluginSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodString>;
     features: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
 }, z.core.$loose>;
-/**
- * Individual agent configuration
- */
 declare const AgentConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     expertise: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1115,9 +1161,6 @@ declare const AgentConfigSchema: z.ZodObject<{
         low: "low";
     }>>>;
 }, z.core.$loose>;
-/**
- * Agents section configuration
- */
 declare const AgentsConfigSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -1137,9 +1180,6 @@ declare const AgentsConfigSchema: z.ZodObject<{
         verbose: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>>;
 }, z.core.$loose>;
-/**
- * Individual skill configuration
- */
 declare const SkillConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     tier: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
@@ -1150,9 +1190,6 @@ declare const SkillConfigSchema: z.ZodObject<{
     category: z.ZodOptional<z.ZodString>;
     maxChars: z.ZodOptional<z.ZodNumber>;
 }, z.core.$loose>;
-/**
- * Skills section configuration
- */
 declare const SkillsConfigSchema: z.ZodObject<{
     categories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -1177,9 +1214,6 @@ declare const SkillsConfigSchema: z.ZodObject<{
         includeExternal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>>;
 }, z.core.$loose>;
-/**
- * Workflow phase schema
- */
 declare const WorkflowPhaseSchema: z.ZodObject<{
     name: z.ZodString;
     agents: z.ZodArray<z.ZodString>;
@@ -1187,9 +1221,6 @@ declare const WorkflowPhaseSchema: z.ZodObject<{
     parallel: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
-/**
- * Individual workflow configuration
- */
 declare const WorkflowConfigSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -1208,9 +1239,6 @@ declare const WorkflowConfigSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
-/**
- * Workflows section configuration
- */
 declare const WorkflowsConfigSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -1239,9 +1267,6 @@ declare const WorkflowsConfigSchema: z.ZodObject<{
         emitTelemetry: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strip>>;
 }, z.core.$loose>;
-/**
- * Quality check configuration
- */
 declare const QualityCheckSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     checks: z.ZodOptional<z.ZodArray<z.ZodEnum<{
@@ -1254,9 +1279,6 @@ declare const QualityCheckSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject
         build: "build";
     }>>>;
 }, z.core.$strip>]>;
-/**
- * Quality section configuration
- */
 declare const QualityConfigSchema: z.ZodObject<{
     preCommit: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -1302,9 +1324,6 @@ declare const QualityConfigSchema: z.ZodObject<{
         lines: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$loose>;
-/**
- * Context generation configuration
- */
 declare const ContextConfigSchema: z.ZodObject<{
     includeEnvVars: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     includeTechStack: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -1318,9 +1337,6 @@ declare const ContextConfigSchema: z.ZodObject<{
     }, z.core.$strip>>>>;
     maxSize: z.ZodOptional<z.ZodNumber>;
 }, z.core.$loose>;
-/**
- * Paths configuration
- */
 declare const PathsConfigSchema: z.ZodObject<{
     context: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     config: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -1329,9 +1345,6 @@ declare const PathsConfigSchema: z.ZodObject<{
     changelog: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     state: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$loose>;
-/**
- * Dashboard configuration
- */
 declare const DashboardConfigSchema: z.ZodObject<{
     port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     autoOpen: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -1342,9 +1355,6 @@ declare const DashboardConfigSchema: z.ZodObject<{
         system: "system";
     }>>>;
 }, z.core.$loose>;
-/**
- * Project information schema
- */
 declare const ProjectConfigSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -1353,9 +1363,6 @@ declare const ProjectConfigSchema: z.ZodObject<{
     license: z.ZodOptional<z.ZodString>;
     repository: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
-/**
- * Technology stack configuration
- */
 declare const StackConfigSchema: z.ZodObject<{
     framework: z.ZodOptional<z.ZodEnum<{
         custom: "custom";
@@ -1394,9 +1401,6 @@ declare const StackConfigSchema: z.ZodObject<{
         "self-hosted": "self-hosted";
     }>>;
 }, z.core.$loose>;
-/**
- * Complete Bootspring configuration schema
- */
 declare const ConfigSchema: z.ZodObject<{
     project: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
@@ -1802,9 +1806,6 @@ type DashboardConfig = z.infer<typeof DashboardConfigSchema>;
 type ConfigProjectConfig = z.infer<typeof ProjectConfigSchema>;
 type ConfigStackConfig = z.infer<typeof StackConfigSchema>;
 type Config = z.infer<typeof ConfigSchema>;
-/**
- * Loaded configuration with internal metadata
- */
 interface LoadedConfig extends ConfigInput {
     _projectRoot?: string | undefined;
     _configPath?: string | null | undefined;
@@ -1813,9 +1814,6 @@ interface LoadedConfig extends ConfigInput {
         skipped: boolean;
     } | undefined;
 }
-/**
- * Validation result
- */
 interface ValidationResult {
     valid: boolean;
     errors: string[];
@@ -1823,17 +1821,11 @@ interface ValidationResult {
     data?: Config | null | undefined;
     validatedAt?: string | undefined;
 }
-/**
- * Section validation result
- */
 interface SectionValidationResult {
     valid: boolean;
     errors: string[];
     data: unknown;
 }
-/**
- * Preset definition
- */
 interface PresetDefinition {
     name: string;
     description: string;
@@ -1841,9 +1833,6 @@ interface PresetDefinition {
     extends: string | null;
     config: Partial<ConfigInput>;
 }
-/**
- * Preset info for listing
- */
 interface PresetInfo {
     key: string;
     name: string;
@@ -1851,92 +1840,80 @@ interface PresetInfo {
     tags?: string[] | undefined;
     extends?: string | null | undefined;
 }
-/**
- * List presets options
- */
 interface ListPresetsOptions {
     tag?: string | undefined;
     verbose?: boolean | undefined;
 }
-/**
- * Validate options
- */
 interface ValidateOptions {
     strict?: boolean | undefined;
     sections?: string[] | undefined;
 }
-/**
- * Load with validation options
- */
 interface LoadWithValidationOptions {
     validate?: boolean | undefined;
     strict?: boolean | undefined;
     silent?: boolean | undefined;
 }
-/**
- * Format Zod validation errors into user-friendly messages
- * Compatible with Zod 4.x
- */
-declare function formatValidationErrors(zodError: z.ZodError): string[];
-/**
- * Validate a specific config section
- */
-declare function validateSection(section: string, data: unknown): SectionValidationResult;
 declare const DEFAULT_CONFIG: ConfigInput;
-declare const CONFIG_FILES: string[];
-declare const CONFIG_PRESETS: Record<string, PresetDefinition>;
 /**
  * Deep merge two objects
  */
 declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
+
 /**
- * Find the project root directory
- */
-declare function findProjectRoot(): string;
-/**
- * Find config file in project
- */
-declare function findConfigFile(projectRoot: string): string | null;
-/**
- * Get a preset configuration
+ * Bootspring Configuration — Presets
+ *
+ * Static preset configurations and preset management functions.
+ *
+ * @package bootspring
+ * @module core/config-presets
  */
+
+declare const CONFIG_PRESETS: Record<string, PresetDefinition>;
 declare function getPreset(presetName: string): PresetDefinition | null;
-/**
- * Resolve preset inheritance chain
- */
 declare function resolvePresetChain(presetName: string, seen?: Set<string>): ConfigInput;
-/**
- * Apply a preset to configuration
- */
 declare function applyPreset(presetNames: string | string[], overrides?: Partial<ConfigInput>): ConfigInput;
-/**
- * Combine multiple presets
- */
 declare function combinePresets(presetNames: string[], overrides?: Partial<ConfigInput>): ConfigInput;
-/**
- * Parse preset string
- */
 declare function parsePresetString(presetString: string): string[];
-/**
- * Validate preset names
- */
 declare function validatePresets(presetNames: string | string[]): {
     valid: boolean;
     errors: string[];
     validPresets: string[];
 };
+declare function getPresetsByTag(tag: string): string[];
+declare function createCustomPreset(baseName: string, newName: string, customConfig?: Partial<ConfigInput>): PresetDefinition;
+declare function listPresets(options?: ListPresetsOptions): PresetInfo[];
+
 /**
- * Get presets by tag
+ * Bootspring Configuration
+ * Handles loading and validating bootspring.config.js
+ *
+ * Split into:
+ *   config-schemas.ts — Zod schemas + inferred types + interfaces
+ *   config-presets.ts — preset data + preset functions
+ *   config.ts (this file) — defaults, helpers, loader, validation, re-exports
+ *
+ * @package bootspring
+ * @module core/config
  */
-declare function getPresetsByTag(tag: string): string[];
+
+declare const CONFIG_FILES: string[];
 /**
- * Create custom preset
+ * Format Zod validation errors into user-friendly messages
+ * Compatible with Zod 4.x
  */
-declare function createCustomPreset(baseName: string, newName: string, customConfig?: Partial<ConfigInput>): PresetDefinition;
+declare function formatValidationErrors(zodError: z.ZodError): string[];
 /**
- * List available presets
+ * Validate a specific config section
  */
-declare function listPresets(options?: ListPresetsOptions): PresetInfo[];
+declare function validateSection(section: string, data: unknown): SectionValidationResult;
+/**
+ * Find the project root directory
+ */
+declare function findProjectRoot(): string;
+/**
+ * Find config file in project
+ */
+declare function findConfigFile(projectRoot: string): string | null;
 /**
  * Load configuration from file
  */
@@ -2281,6 +2258,10 @@ interface UploadOptions {
     clearOnSuccess?: boolean | undefined;
     maxRetries?: number | undefined;
     retryDelayMs?: number | undefined;
+    /** Pass directly to avoid dynamic import of auth module */
+    apiKey?: string | undefined;
+    /** Pass directly to avoid dynamic import of session module */
+    projectId?: string | undefined;
 }
 /**
  * Emit event options
@@ -2422,4 +2403,4 @@ declare namespace telemetry {
   export { telemetry_ASSISTANTS as ASSISTANTS, telemetry_ASSISTANT_FIRST_SUCCESS_EVENT as ASSISTANT_FIRST_SUCCESS_EVENT, telemetry_ASSISTANT_RETURN_EVENT as ASSISTANT_RETURN_EVENT, telemetry_ASSISTANT_SETUP_EVENT as ASSISTANT_SETUP_EVENT, type telemetry_AssistantFunnelEntry as AssistantFunnelEntry, type telemetry_AssistantFunnelSummary as AssistantFunnelSummary, type telemetry_AssistantId as AssistantId, type telemetry_AssistantTrackOptions as AssistantTrackOptions, type telemetry_AssistantUsageTrackResult as AssistantUsageTrackResult, telemetry_BILLING_UPGRADE_STARTED_EVENT as BILLING_UPGRADE_STARTED_EVENT, type telemetry_ClearResult as ClearResult, type telemetry_EmitOptions as EmitOptions, type telemetry_FailedBatch as FailedBatch, type telemetry_ListEventsOptions as ListEventsOptions, telemetry_MAX_EVENTS_LIMIT as MAX_EVENTS_LIMIT, type telemetry_TelemetryRecord as TelemetryRecord, type telemetry_TelemetryStatus as TelemetryStatus, telemetry_UPGRADE_COMPLETED_EVENT as UPGRADE_COMPLETED_EVENT, telemetry_UPGRADE_PROMPT_EVENT as UPGRADE_PROMPT_EVENT, type telemetry_UpgradeFunnelEntry as UpgradeFunnelEntry, type telemetry_UpgradeFunnelSummary as UpgradeFunnelSummary, type telemetry_UploadOptions as UploadOptions, type telemetry_UploadResult as UploadResult, telemetry_clearEvents as clearEvents, telemetry_emitEvent as emitEvent, telemetry_ensureTelemetryDir as ensureTelemetryDir, telemetry_getAssistantActivationFunnel as getAssistantActivationFunnel, telemetry_getStatus as getStatus, telemetry_getTelemetryDir as getTelemetryDir, telemetry_getTelemetryFile as getTelemetryFile, telemetry_getUpgradeConversionFunnel as getUpgradeConversionFunnel, telemetry_inferAssistantFromEnvironment as inferAssistantFromEnvironment, telemetry_listEvents as listEvents, telemetry_track as track, telemetry_trackAssistantSetup as trackAssistantSetup, telemetry_trackAssistantUsageSuccess as trackAssistantUsageSuccess, telemetry_uploadEvents as uploadEvents };
 }
 
-export { API_BASE, API_VERSION, BOOTSPRING_DIR, COMMANDS_SOURCE, CONFIG_FILE, CREDENTIALS_FILE, CURRENT_VERSION, DEFAULT_INTERVAL_MS, DEFAULT_POLICY_PROFILE, DEVICE_FILE, type DiagnosticResult, type ExpiryStatus, type HealResult, type Issue, LIMITS, LOCAL_CONFIG_NAME, PACKAGE_NAME, PATTERNS, POLICY_PROFILES, type PolicyOptions, type PolicyProfile, type ProjectContext$1 as ProjectContext, SESSION_FILE, SHELL_DANGEROUS_CHARS, STATE_PATH, type SessionData, TARGET_DIRS, type ValidationResult$1 as ValidationResult, type Workflow, addRecentProject, apiClient as api, apiLogin, applyUpdate, auth, checkForUpdates, checkInstallation, classifyError, clearCredentials, clearDeviceInfo, clearProjectApiKey, clearProjectScopedSession, clearSession, compareVersions, config, context, createLocalConfig, decrypt, encrypt, ensureBootspringDir, ensureLatestVersion, entitlements, findLocalConfig, findNearestProjectConfigPath, generateDeviceFingerprint, getApiKey, getCommandFiles, getConfig, getCredentials, getCredentialsPath, getCurrentProject, getDeviceContext, getDeviceId, getDeviceInfo, getEffectiveProject, getInstallContext, getLatestVersion, getLegacyProjectApiKey, getPolicyProfile, getProjectScopedSessionState, getProjectScopedToken, getRecentProjects, getRefreshToken, getSession, getSessionState, getStoredApiKey, getTier$1 as getTier, getToken, getTokenExpiryStatus, getUser, healthCheck, installAll, installToTarget, isApiKeyAuth, isAuthenticated, isWorkflowBlocked, login, loginWithApiKey, logout, maybeAutoUploadTelemetry, normalizeProfile, policies, pollDeviceToken, presence, readNearestProjectConfig, request, resolvePolicyProfile, runDiagnostics, saveApiKeyToProject, saveConfig, saveCredentials, saveProjectScopedSession, saveSession, selfHeal, selfUpdate, sendHealthReport, sendHeartbeat, session, setAuthFailureHandler, setCurrentProject, setupCommands, startDeviceFlow, stripUnsafeControlChars, telemetry, tierEnforcement, tryHeal, uninstallAll, updateTokens, validateNumericId, validateSlug, validateStringLength, validateTodoText, writeNearestProjectConfig };
+export { API_BASE, API_VERSION, BOOTSPRING_DIR, type BootspringConfig, COMMANDS_SOURCE, CONFIG_FILE, CREDENTIALS_FILE, CURRENT_VERSION, type Credentials, DEFAULT_INTERVAL_MS, DEFAULT_POLICY_PROFILE, DEVICE_FILE, type DeviceContext, type DeviceInfo, type DiagnosticResult, type ExpiryStatus, type HealResult, type Issue, LIMITS, LOCAL_CONFIG_NAME, type LoginResponse, PACKAGE_NAME, PATTERNS, POLICY_PROFILES, type PolicyOptions, type PolicyProfile, type ProjectAuth, type ProjectConfig, type ProjectContext$1 as ProjectContext, SESSION_FILE, SHELL_DANGEROUS_CHARS, STATE_PATH, type SessionData, type SessionOptions, TARGET_DIRS, type UserProfile, type ValidationResult$1 as ValidationResult, type Workflow, addRecentProject, apiClient as api, apiLogin, applyUpdate, auth, callMcpTool, checkForUpdates, checkInstallation, classifyError, clearCredentials, clearDeviceInfo, clearProjectApiKey, clearProjectScopedSession, clearSession, compareVersions, config, context, createLocalConfig, decrypt, encrypt, ensureBootspringDir, ensureLatestVersion, entitlements, findLocalConfig, findNearestProjectConfigPath, generateDeviceFingerprint, getApiKey, getCommandFiles, getConfig, getCredentials, getCredentialsPath, getCurrentProject, getDeviceContext, getDeviceId, getDeviceInfo, getEffectiveProject, getInstallContext, getLatestVersion, getLegacyProjectApiKey, getMcpResource, getPolicyProfile, getProjectScopedSessionState, getProjectScopedToken, getRecentProjects, getRefreshToken, getSession, getSessionState, getStoredApiKey, getTier$1 as getTier, getToken, getTokenExpiryStatus, getUser, healthCheck, installAll, installToTarget, isApiKeyAuth, isAuthenticated, isWorkflowBlocked, listMcpResources, listMcpTools, login, loginWithApiKey, logout, maybeAutoUploadTelemetry, normalizeProfile, policies, pollDeviceToken, presence, readNearestProjectConfig, refreshSession, remoteLogout, request, resolvePolicyProfile, runDiagnostics, saveApiKeyToProject, saveConfig, saveCredentials, saveProjectScopedSession, saveSession, selfHeal, selfUpdate, sendHealthReport, sendHeartbeat, session, setAuthFailureHandler, setCurrentProject, setupCommands, startDeviceFlow, stripUnsafeControlChars, telemetry, tierEnforcement, tryHeal, uninstallAll, updateTokens, validateNumericId, validateSlug, validateStringLength, validateTodoText, writeNearestProjectConfig };