promptspeak-mcp-server 0.1.0

package/dist/boot-camp/types.d.ts

@@ -0,0 +1,342 @@
+/**
+ * Marine Agent Boot Camp Protocol - Type Definitions
+ *
+ * Training system based on United States Marine Corps Recruit Training doctrine.
+ * Agents must complete all 6 phases before being certified for live trading.
+ *
+ * Phase Mapping:
+ * 1. Receiving (Week 1-2)     -> Agent initialization and configuration
+ * 2. Conditioning (Week 3-4)  -> Strategy calibration
+ * 3. Marksmanship (Week 5-6)  -> Bid accuracy training
+ * 4. Combat (Week 7-9)        -> Live market simulation
+ * 5. Crucible (Week 10-11)    -> Stress testing with limited budget
+ * 6. Graduation (Week 12-13)  -> Certification for live trading
+ */
+import type { BiddingStrategy, Money } from '../swarm/types.js';
+/**
+ * Boot Camp training phases - mirrors USMC recruit training structure.
+ */
+export type TrainingPhase = 'RECEIVING' | 'CONDITIONING' | 'MARKSMANSHIP' | 'COMBAT' | 'CRUCIBLE' | 'GRADUATION';
+/**
+ * Phase progression order.
+ */
+export declare const PHASE_ORDER: TrainingPhase[];
+/**
+ * Get the next phase after a given phase.
+ */
+export declare function getNextPhase(current: TrainingPhase): TrainingPhase | null;
+/**
+ * Phase-specific configuration.
+ */
+export interface PhaseConfig {
+    /** Phase identifier */
+    phase: TrainingPhase;
+    /** Minimum duration in milliseconds */
+    minDurationMs: number;
+    /** Maximum attempts before washout */
+    maxAttempts: number;
+    /** Required score to pass (0-100) */
+    passingScore: number;
+    /** Phase description */
+    description: string;
+    /** Training exercises for this phase */
+    exercises: string[];
+}
+/**
+ * Default phase configurations - based on USMC 13-week program.
+ */
+export declare const DEFAULT_PHASE_CONFIGS: Record<TrainingPhase, PhaseConfig>;
+/**
+ * Recruit status in Boot Camp.
+ */
+export type RecruitStatus = 'ENLISTED' | 'IN_TRAINING' | 'PHASE_COMPLETE' | 'RECYCLED' | 'MEDICAL_HOLD' | 'DROPPED' | 'GRADUATED' | 'COMBAT_READY';
+/**
+ * Qualification levels for marksmanship (bid accuracy).
+ */
+export type MarksmanshipQualification = 'UNQUALIFIED' | 'MARKSMAN' | 'SHARPSHOOTER' | 'EXPERT';
+/**
+ * Get qualification level from score.
+ */
+export declare function getMarksmanshipQualification(score: number): MarksmanshipQualification;
+/**
+ * Exercise type for training.
+ */
+export type ExerciseType = 'CONFIGURATION_VALIDATION' | 'CREDENTIAL_VERIFICATION' | 'BUDGET_ALLOCATION_TEST' | 'BASIC_API_CONNECTION' | 'STRATEGY_ALIGNMENT_DRILL' | 'DECISION_SPEED_TEST' | 'PARAMETER_TUNING' | 'STRESS_RESPONSE_CHECK' | 'BID_ACCURACY_DRILL' | 'TIMING_PRECISION_TEST' | 'VALUE_ASSESSMENT_TEST' | 'SNIPE_WINDOW_DRILL' | 'LIVE_SANDBOX_SIMULATION' | 'COMPETITIVE_SCENARIO' | 'MULTI_LISTING_MANAGEMENT' | 'SELLER_INTERACTION_DRILL' | 'LIMITED_BUDGET_OPERATION' | 'HIGH_COMPETITION_SCENARIO' | 'RAPID_DECISION_SEQUENCE' | 'RECOVERY_FROM_LOSS' | 'FULL_CAPABILITY_ASSESSMENT' | 'FINAL_INSPECTION' | 'CERTIFICATION_EXAM';
+/**
+ * Result of a single exercise.
+ */
+export interface ExerciseResult {
+    /** Exercise identifier */
+    exerciseId: string;
+    /** Type of exercise */
+    exerciseType: ExerciseType;
+    /** Phase this exercise belongs to */
+    phase: TrainingPhase;
+    /** Score achieved (0-100) */
+    score: number;
+    /** Whether the exercise was passed */
+    passed: boolean;
+    /** Time taken in milliseconds */
+    durationMs: number;
+    /** Timestamp of completion */
+    completedAt: string;
+    /** Detailed metrics from the exercise */
+    metrics: ExerciseMetrics;
+    /** Instructor notes/feedback */
+    feedback?: string;
+}
+/**
+ * Metrics collected during an exercise.
+ */
+export interface ExerciseMetrics {
+    /** Number of decisions made */
+    decisionsCount: number;
+    /** Correct decisions */
+    correctDecisions: number;
+    /** Average decision time in ms */
+    avgDecisionTimeMs: number;
+    /** Bids placed */
+    bidsPlaced?: number;
+    /** Successful bids */
+    successfulBids?: number;
+    /** Budget efficiency (value acquired / budget spent) */
+    budgetEfficiency?: number;
+    /** Timing accuracy percentage */
+    timingAccuracy?: number;
+    /** Custom metrics per exercise type (supports any JSON-serializable values) */
+    custom?: Record<string, unknown>;
+}
+/**
+ * Phase evaluation result.
+ */
+export interface PhaseEvaluation {
+    /** Phase being evaluated */
+    phase: TrainingPhase;
+    /** Overall score for the phase (0-100) */
+    score: number;
+    /** Whether the phase was passed */
+    passed: boolean;
+    /** Attempt number */
+    attemptNumber: number;
+    /** Exercise results for this phase */
+    exerciseResults: ExerciseResult[];
+    /** Started at timestamp */
+    startedAt: string;
+    /** Completed at timestamp */
+    completedAt: string;
+    /** Drill Instructor who certified the pass/fail */
+    certifiedBy?: string;
+    /** Notes from evaluation */
+    notes?: string;
+}
+/**
+ * Complete training record for a recruit (agent).
+ * This is the "Service Record Book" (SRB) equivalent.
+ */
+export interface RecruitRecord {
+    /** Unique recruit ID (same as agent ID) */
+    recruitId: string;
+    /** Agent configuration reference */
+    agentId: string;
+    /** Swarm this recruit belongs to */
+    swarmId: string;
+    /** Human-readable name */
+    name: string;
+    /** Assigned bidding strategy */
+    strategy: BiddingStrategy;
+    /** Current status */
+    status: RecruitStatus;
+    /** Current phase in training */
+    currentPhase: TrainingPhase;
+    /** Training budget allocation (for simulated exercises) */
+    trainingBudget: Money;
+    /** Training budget spent */
+    trainingBudgetSpent: Money;
+    /** Phase evaluations (history) */
+    phaseHistory: PhaseEvaluation[];
+    /** Current phase attempt number */
+    currentAttempt: number;
+    /** Total recyclings (restarts) */
+    totalRecyclings: number;
+    /** Marksmanship qualification achieved */
+    marksmanshipQual?: MarksmanshipQualification;
+    /** Expert badges earned */
+    expertBadges: ExerciseType[];
+    /** Merits earned (above and beyond performance) */
+    merits: string[];
+    /** Demerits accumulated (failures, issues) */
+    demerits: string[];
+    /** Enlistment date */
+    enlistedAt: string;
+    /** Training start date */
+    trainingStartedAt?: string;
+    /** Graduation date */
+    graduatedAt?: string;
+    /** Last activity */
+    lastActivityAt: string;
+    /** Assigned DI (for oversight) */
+    assignedDI?: string;
+    /** Requires DI approval for advancement */
+    requiresDIApproval: boolean;
+    /** DI notes/observations */
+    diNotes: string[];
+}
+/**
+ * Boot Camp configuration for a swarm.
+ */
+export interface BootCampConfig {
+    /** Boot Camp ID */
+    bootCampId: string;
+    /** Associated swarm ID */
+    swarmId: string;
+    /** Boot Camp name (e.g., "MCRD San Diego Class 2024-01") */
+    name: string;
+    /** Phase configurations (can override defaults) */
+    phaseConfigs: Record<TrainingPhase, PhaseConfig>;
+    /** Training budget per recruit */
+    trainingBudgetPerRecruit: Money;
+    /** Whether to require DI approval for graduation */
+    requireDIApproval: boolean;
+    /** Whether to allow phase recycling */
+    allowRecycling: boolean;
+    /** Maximum total recyclings allowed */
+    maxTotalRecyclings: number;
+    /** Automatic advancement (skip DI review) */
+    autoAdvance: boolean;
+    /** Created at */
+    createdAt: string;
+    /** Created by */
+    createdBy: string;
+}
+/**
+ * Default Boot Camp configuration.
+ */
+export declare const DEFAULT_BOOT_CAMP_CONFIG: Omit<BootCampConfig, 'bootCampId' | 'swarmId' | 'name' | 'createdAt' | 'createdBy'>;
+/**
+ * Boot Camp operational status.
+ */
+export type BootCampStatus = 'PREPARING' | 'RECEIVING' | 'ACTIVE' | 'GRADUATED' | 'TERMINATED';
+/**
+ * Boot Camp runtime state.
+ */
+export interface BootCampState {
+    /** Current status */
+    status: BootCampStatus;
+    /** Total recruits enrolled */
+    totalRecruits: number;
+    /** Currently in training */
+    inTraining: number;
+    /** Graduated count */
+    graduated: number;
+    /** Dropped count */
+    dropped: number;
+    /** Current phase breakdown */
+    phaseBreakdown: Record<TrainingPhase, number>;
+    /** Training budget total */
+    totalTrainingBudget: Money;
+    /** Training budget spent */
+    trainingBudgetSpent: Money;
+    /** Start date */
+    startedAt?: string;
+    /** Completion date */
+    completedAt?: string;
+    /** Last activity */
+    lastActivityAt: string;
+}
+/**
+ * Drill Instructor record.
+ * DIs are responsible for oversight, evaluation, and certification.
+ */
+export interface DrillInstructor {
+    /** DI identifier */
+    diId: string;
+    /** DI name/callsign */
+    name: string;
+    /** User ID (for human oversight) */
+    userId?: string;
+    /** Is automated DI (AI-based) */
+    isAutomated: boolean;
+    /** Specialty areas */
+    specialties: BiddingStrategy[];
+    /** Recruits currently assigned */
+    assignedRecruits: string[];
+    /** Total recruits graduated */
+    totalGraduated: number;
+    /** Total recruits dropped */
+    totalDropped: number;
+    /** Notes/bio */
+    notes?: string;
+    /** Created at */
+    createdAt: string;
+}
+/**
+ * DI review request.
+ */
+export interface DIReviewRequest {
+    /** Request ID */
+    requestId: string;
+    /** Recruit requesting review */
+    recruitId: string;
+    /** Phase to be certified */
+    phase: TrainingPhase;
+    /** Phase evaluation to review */
+    evaluation: PhaseEvaluation;
+    /** Assigned DI */
+    assignedDI?: string;
+    /** Request status */
+    status: 'PENDING' | 'APPROVED' | 'REJECTED' | 'RECYCLED';
+    /** Review notes */
+    reviewNotes?: string;
+    /** Created at */
+    createdAt: string;
+    /** Reviewed at */
+    reviewedAt?: string;
+}
+/**
+ * Boot Camp event types.
+ */
+export type BootCampEventType = 'RECRUIT_ENLISTED' | 'RECRUIT_TRAINING_STARTED' | 'RECRUIT_PHASE_STARTED' | 'RECRUIT_EXERCISE_COMPLETED' | 'RECRUIT_PHASE_PASSED' | 'RECRUIT_PHASE_FAILED' | 'RECRUIT_RECYCLED' | 'RECRUIT_DROPPED' | 'RECRUIT_GRADUATED' | 'RECRUIT_DEPLOYED' | 'BOOT_CAMP_CREATED' | 'BOOT_CAMP_STARTED' | 'BOOT_CAMP_COMPLETED' | 'BOOT_CAMP_TERMINATED' | 'DI_ASSIGNED' | 'DI_REVIEW_REQUESTED' | 'DI_REVIEW_COMPLETED' | 'MERIT_AWARDED' | 'DEMERIT_ISSUED' | 'QUALIFICATION_EARNED' | 'EXPERT_BADGE_EARNED';
+/**
+ * Boot Camp event.
+ */
+export interface BootCampEvent {
+    /** Event ID */
+    eventId: string;
+    /** Event type */
+    eventType: BootCampEventType;
+    /** Boot Camp ID */
+    bootCampId: string;
+    /** Recruit ID (if applicable) */
+    recruitId?: string;
+    /** DI ID (if applicable) */
+    diId?: string;
+    /** Timestamp */
+    timestamp: string;
+    /** Event data */
+    data?: Record<string, unknown>;
+}
+/**
+ * Generate a Boot Camp ID.
+ */
+export declare function generateBootCampId(): string;
+/**
+ * Generate a recruit ID.
+ */
+export declare function generateRecruitId(): string;
+/**
+ * Generate an exercise ID.
+ */
+export declare function generateExerciseId(): string;
+/**
+ * Generate a DI ID.
+ */
+export declare function generateDIId(): string;
+/**
+ * Generate a review request ID.
+ */
+export declare function generateReviewRequestId(): string;
+/**
+ * Generate an event ID.
+ */
+export declare function generateBootCampEventId(): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/boot-camp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/boot-camp/types.ts"],"names":[],"mappings":"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"}

package/dist/boot-camp/types.js

@@ -0,0 +1,179 @@
+/**
+ * Marine Agent Boot Camp Protocol - Type Definitions
+ *
+ * Training system based on United States Marine Corps Recruit Training doctrine.
+ * Agents must complete all 6 phases before being certified for live trading.
+ *
+ * Phase Mapping:
+ * 1. Receiving (Week 1-2)     -> Agent initialization and configuration
+ * 2. Conditioning (Week 3-4)  -> Strategy calibration
+ * 3. Marksmanship (Week 5-6)  -> Bid accuracy training
+ * 4. Combat (Week 7-9)        -> Live market simulation
+ * 5. Crucible (Week 10-11)    -> Stress testing with limited budget
+ * 6. Graduation (Week 12-13)  -> Certification for live trading
+ */
+/**
+ * Phase progression order.
+ */
+export const PHASE_ORDER = [
+    'RECEIVING',
+    'CONDITIONING',
+    'MARKSMANSHIP',
+    'COMBAT',
+    'CRUCIBLE',
+    'GRADUATION',
+];
+/**
+ * Get the next phase after a given phase.
+ */
+export function getNextPhase(current) {
+    const idx = PHASE_ORDER.indexOf(current);
+    if (idx === -1 || idx === PHASE_ORDER.length - 1)
+        return null;
+    return PHASE_ORDER[idx + 1];
+}
+/**
+ * Default phase configurations - based on USMC 13-week program.
+ */
+export const DEFAULT_PHASE_CONFIGS = {
+    RECEIVING: {
+        phase: 'RECEIVING',
+        minDurationMs: 60000, // 1 minute (simulated 2 weeks)
+        maxAttempts: 3,
+        passingScore: 70,
+        description: 'Initial processing, haircut, gear issue, initial strength test',
+        exercises: [
+            'CONFIGURATION_VALIDATION',
+            'CREDENTIAL_VERIFICATION',
+            'BUDGET_ALLOCATION_TEST',
+            'BASIC_API_CONNECTION',
+        ],
+    },
+    CONDITIONING: {
+        phase: 'CONDITIONING',
+        minDurationMs: 120000, // 2 minutes (simulated 2 weeks)
+        maxAttempts: 5,
+        passingScore: 75,
+        description: 'Physical and mental conditioning - close order drill, PT',
+        exercises: [
+            'STRATEGY_ALIGNMENT_DRILL',
+            'DECISION_SPEED_TEST',
+            'PARAMETER_TUNING',
+            'STRESS_RESPONSE_CHECK',
+        ],
+    },
+    MARKSMANSHIP: {
+        phase: 'MARKSMANSHIP',
+        minDurationMs: 180000, // 3 minutes (simulated 2 weeks)
+        maxAttempts: 5,
+        passingScore: 80,
+        description: 'Rifle range qualification - snap in, known distance course',
+        exercises: [
+            'BID_ACCURACY_DRILL',
+            'TIMING_PRECISION_TEST',
+            'VALUE_ASSESSMENT_TEST',
+            'SNIPE_WINDOW_DRILL',
+        ],
+    },
+    COMBAT: {
+        phase: 'COMBAT',
+        minDurationMs: 300000, // 5 minutes (simulated 3 weeks)
+        maxAttempts: 3,
+        passingScore: 75,
+        description: 'Field training exercises - MOUT, patrolling, defensive operations',
+        exercises: [
+            'LIVE_SANDBOX_SIMULATION',
+            'COMPETITIVE_SCENARIO',
+            'MULTI_LISTING_MANAGEMENT',
+            'SELLER_INTERACTION_DRILL',
+        ],
+    },
+    CRUCIBLE: {
+        phase: 'CRUCIBLE',
+        minDurationMs: 240000, // 4 minutes (simulated 54 hours)
+        maxAttempts: 2,
+        passingScore: 85,
+        description: '54-hour final challenge with food/sleep deprivation simulation',
+        exercises: [
+            'LIMITED_BUDGET_OPERATION',
+            'HIGH_COMPETITION_SCENARIO',
+            'RAPID_DECISION_SEQUENCE',
+            'RECOVERY_FROM_LOSS',
+        ],
+    },
+    GRADUATION: {
+        phase: 'GRADUATION',
+        minDurationMs: 60000, // 1 minute (final inspection)
+        maxAttempts: 1,
+        passingScore: 90,
+        description: 'Final inspection, EGA ceremony, graduation parade',
+        exercises: [
+            'FULL_CAPABILITY_ASSESSMENT',
+            'FINAL_INSPECTION',
+            'CERTIFICATION_EXAM',
+        ],
+    },
+};
+/**
+ * Get qualification level from score.
+ */
+export function getMarksmanshipQualification(score) {
+    if (score >= 90)
+        return 'EXPERT';
+    if (score >= 80)
+        return 'SHARPSHOOTER';
+    if (score >= 70)
+        return 'MARKSMAN';
+    return 'UNQUALIFIED';
+}
+/**
+ * Default Boot Camp configuration.
+ */
+export const DEFAULT_BOOT_CAMP_CONFIG = {
+    phaseConfigs: DEFAULT_PHASE_CONFIGS,
+    trainingBudgetPerRecruit: { value: 100, currency: 'USD' },
+    requireDIApproval: true,
+    allowRecycling: true,
+    maxTotalRecyclings: 3,
+    autoAdvance: false,
+};
+// =============================================================================
+// ID GENERATORS
+// =============================================================================
+/**
+ * Generate a Boot Camp ID.
+ */
+export function generateBootCampId() {
+    return `bc_${Date.now()}_${Math.random().toString(36).substr(2, 8)}`;
+}
+/**
+ * Generate a recruit ID.
+ */
+export function generateRecruitId() {
+    return `rct_${Date.now()}_${Math.random().toString(36).substr(2, 8)}`;
+}
+/**
+ * Generate an exercise ID.
+ */
+export function generateExerciseId() {
+    return `ex_${Date.now()}_${Math.random().toString(36).substr(2, 8)}`;
+}
+/**
+ * Generate a DI ID.
+ */
+export function generateDIId() {
+    return `di_${Date.now()}_${Math.random().toString(36).substr(2, 8)}`;
+}
+/**
+ * Generate a review request ID.
+ */
+export function generateReviewRequestId() {
+    return `drv_${Date.now()}_${Math.random().toString(36).substr(2, 8)}`;
+}
+/**
+ * Generate an event ID.
+ */
+export function generateBootCampEventId() {
+    return `bc_evt_${Date.now()}_${Math.random().toString(36).substr(2, 12)}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/boot-camp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/boot-camp/types.ts"],"names":[],"mappings":"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"}

package/dist/core/config/env.d.ts

@@ -0,0 +1,146 @@
+/**
+ * ===============================================================================
+ * ENVIRONMENT VARIABLE UTILITIES
+ * ===============================================================================
+ *
+ * Type-safe utilities for reading environment variables with validation.
+ * Extracted from http/config.ts for reuse across the codebase.
+ *
+ * Usage:
+ *   import { getEnv, getEnvNumber, getEnvBoolean } from '../core/config/env.js';
+ *
+ *   const port = getEnvNumber('PORT', 3000);
+ *   const debug = getEnvBoolean('DEBUG', false);
+ *   const apiKey = getEnv('API_KEY');  // throws if missing
+ *
+ * ===============================================================================
+ */
+/**
+ * Get a required environment variable.
+ * Throws if the variable is not set and no default is provided.
+ *
+ * @param key - Environment variable name
+ * @param defaultValue - Optional default value
+ * @returns The environment variable value
+ * @throws Error if variable is missing and no default provided
+ */
+export declare function getEnv(key: string, defaultValue?: string): string;
+/**
+ * Get an optional environment variable with a default value.
+ * Never throws - always returns a value.
+ *
+ * @param key - Environment variable name
+ * @param defaultValue - Default value if not set
+ * @returns The environment variable value or default
+ */
+export declare function getEnvOptional(key: string, defaultValue: string): string;
+/**
+ * Get an optional environment variable, returning undefined if not set.
+ *
+ * @param key - Environment variable name
+ * @returns The environment variable value or undefined
+ */
+export declare function getEnvOrUndefined(key: string): string | undefined;
+/**
+ * Get an environment variable as a number.
+ *
+ * @param key - Environment variable name
+ * @param defaultValue - Default value if not set
+ * @returns Parsed number value
+ * @throws Error if value is not a valid number
+ */
+export declare function getEnvNumber(key: string, defaultValue: number): number;
+/**
+ * Get an environment variable as a float.
+ *
+ * @param key - Environment variable name
+ * @param defaultValue - Default value if not set
+ * @returns Parsed float value
+ * @throws Error if value is not a valid number
+ */
+export declare function getEnvFloat(key: string, defaultValue: number): number;
+/**
+ * Get an environment variable as a boolean.
+ * Accepts: 'true', '1', 'yes', 'on' (case-insensitive) as truthy.
+ *
+ * @param key - Environment variable name
+ * @param defaultValue - Default value if not set
+ * @returns Boolean value
+ */
+export declare function getEnvBoolean(key: string, defaultValue: boolean): boolean;
+/**
+ * Get an environment variable as a comma-separated list.
+ *
+ * @param key - Environment variable name
+ * @param defaultValue - Default array if not set
+ * @param separator - Separator character (default: ',')
+ * @returns Array of trimmed strings
+ */
+export declare function getEnvList(key: string, defaultValue?: string[], separator?: string): string[];
+/**
+ * Get an environment variable as a JSON object.
+ *
+ * @param key - Environment variable name
+ * @param defaultValue - Default value if not set
+ * @returns Parsed JSON object
+ * @throws Error if value is not valid JSON
+ */
+export declare function getEnvJson<T>(key: string, defaultValue: T): T;
+/**
+ * Get an environment variable constrained to specific values (enum-like).
+ *
+ * @param key - Environment variable name
+ * @param allowedValues - Array of allowed values
+ * @param defaultValue - Default value if not set
+ * @returns The environment variable value
+ * @throws Error if value is not in allowed values
+ */
+export declare function getEnvEnum<T extends string>(key: string, allowedValues: readonly T[], defaultValue: T): T;
+/**
+ * Result of environment validation.
+ */
+export interface EnvValidationResult {
+    /** Whether all required variables are present */
+    valid: boolean;
+    /** List of missing required variables */
+    missing: string[];
+    /** List of invalid variables (wrong format) */
+    invalid: Array<{
+        key: string;
+        reason: string;
+    }>;
+}
+/**
+ * Validate that required environment variables are set.
+ *
+ * @param required - Array of required variable names
+ * @returns Validation result
+ */
+export declare function validateRequiredEnv(required: string[]): EnvValidationResult;
+/**
+ * Check if an environment variable is set (non-empty).
+ *
+ * @param key - Environment variable name
+ * @returns true if the variable is set and non-empty
+ */
+export declare function hasEnv(key: string): boolean;
+/**
+ * Get the current Node environment.
+ *
+ * @param defaultEnv - Default environment if NODE_ENV is not set
+ * @returns Current environment name
+ */
+export declare function getNodeEnv(defaultEnv?: 'development' | 'production' | 'test'): 'development' | 'production' | 'test';
+/**
+ * Check if running in production mode.
+ */
+export declare function isProduction(): boolean;
+/**
+ * Check if running in development mode.
+ */
+export declare function isDevelopment(): boolean;
+/**
+ * Check if running in test mode.
+ */
+export declare function isTest(): boolean;
+//# sourceMappingURL=env.d.ts.map