deepseek-coder-cli 1.0.0

package/dist/core/selfUpgrade.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Self-Upgrade System for AGI Core
+ *
+ * Provides the ability to:
+ * 1. npm install a fresh version of the CLI
+ * 2. Launch a new CLI instance
+ * 3. Continue work seamlessly after upgrade
+ * 4. Integrate with edits, builds, tests, and RL scoring
+ *
+ * This module enables true self-improvement through version updates
+ * while maintaining session continuity.
+ */
+import { EventEmitter } from 'node:events';
+export interface SelfUpgradeConfig {
+    /** Package name to upgrade (default: agi-core-cli) */
+    packageName?: string;
+    /** Whether to run in global mode (default: true) */
+    global?: boolean;
+    /** Working directory for session resumption */
+    workingDir?: string;
+    /** Custom logger function */
+    logger?: (message: string) => void;
+    /** Timeout for npm operations in ms (default: 5 minutes) */
+    timeout?: number;
+    /** Whether to automatically restart after upgrade */
+    autoRestart?: boolean;
+    /** Session state to preserve across upgrade */
+    sessionState?: UpgradeSessionState;
+}
+export interface UpgradeSessionState {
+    /** Current working directory */
+    workingDir: string;
+    /** Pending tasks to continue */
+    pendingTasks?: string[];
+    /** Last user prompt */
+    lastPrompt?: string;
+    /** Context summary for resumption */
+    contextSummary?: string;
+    /** Current version before upgrade */
+    fromVersion: string;
+    /** Target version after upgrade */
+    toVersion?: string;
+    /** Timestamp of upgrade initiation */
+    timestamp: number;
+    /** RL iteration context if applicable */
+    rlContext?: RLUpgradeContext;
+    /** Files being edited before upgrade */
+    activeEdits?: string[];
+    /** Build state before upgrade */
+    buildState?: BuildState;
+    /** Test state before upgrade */
+    testState?: TestState;
+}
+export interface RLUpgradeContext {
+    /** Current iteration number */
+    iteration: number;
+    /** Current agent variant */
+    variant: 'primary' | 'refiner';
+    /** Objective being worked on */
+    objective: string;
+    /** Current score before upgrade */
+    currentScore: number;
+    /** Files modified so far */
+    filesModified: string[];
+}
+export interface BuildState {
+    /** Whether build was successful */
+    success: boolean;
+    /** Build output/errors */
+    output?: string;
+    /** Build command used */
+    command?: string;
+}
+export interface TestState {
+    /** Number of tests passed */
+    passed: number;
+    /** Number of tests failed */
+    failed: number;
+    /** Test output */
+    output?: string;
+    /** Test command used */
+    command?: string;
+}
+export interface UpgradeResult {
+    /** Whether upgrade was successful */
+    success: boolean;
+    /** Previous version */
+    fromVersion: string;
+    /** New version (if successful) */
+    toVersion?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Whether CLI was restarted */
+    restarted: boolean;
+    /** Duration of upgrade in ms */
+    durationMs: number;
+    /** RL score impact (if applicable) */
+    rlScoreImpact?: number;
+}
+export interface VersionInfo {
+    /** Current installed version */
+    current: string;
+    /** Latest available version */
+    latest: string;
+    /** Whether update is available */
+    updateAvailable: boolean;
+    /** Release notes URL */
+    releaseNotesUrl?: string;
+}
+export type UpgradeEventType = 'upgrade:start' | 'upgrade:download' | 'upgrade:install' | 'upgrade:complete' | 'upgrade:error' | 'upgrade:restart' | 'upgrade:resume' | 'upgrade:rl-checkpoint';
+export interface UpgradeEvent {
+    type: UpgradeEventType;
+    timestamp: number;
+    data?: Record<string, unknown>;
+}
+export declare class SelfUpgrade extends EventEmitter {
+    private config;
+    private upgradeInProgress;
+    private childProcess;
+    constructor(config?: SelfUpgradeConfig);
+    /**
+     * Check for available updates
+     */
+    checkForUpdates(): Promise<VersionInfo>;
+    /**
+     * Get currently installed version
+     */
+    getCurrentVersion(): Promise<string>;
+    /**
+     * Get latest available version from npm registry
+     */
+    getLatestVersion(): Promise<string>;
+    /**
+     * Compare two semver versions
+     * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+     */
+    private compareVersions;
+    /**
+     * Perform npm install of fresh version
+     */
+    npmInstallFresh(version?: string): Promise<UpgradeResult>;
+    /**
+     * Launch a new CLI instance and optionally continue work
+     */
+    launchNewInstance(resumeSession?: boolean): Promise<boolean>;
+    /**
+     * Save session state for resumption after upgrade
+     */
+    saveSessionState(state: UpgradeSessionState): void;
+    /**
+     * Load session state after upgrade
+     */
+    loadSessionState(): UpgradeSessionState | null;
+    /**
+     * Clear session state after successful resumption
+     */
+    clearSessionState(): void;
+    /**
+     * Check if there's a pending session to resume
+     */
+    hasPendingSession(): boolean;
+    /**
+     * Save RL checkpoint before upgrade (for RL scoring continuity)
+     */
+    saveRLCheckpoint(context: RLUpgradeContext): void;
+    /**
+     * Load RL checkpoint after upgrade
+     */
+    loadRLCheckpoint(): RLUpgradeContext | null;
+    /**
+     * Clear RL checkpoint after successful resumption
+     */
+    clearRLCheckpoint(): void;
+    /**
+     * Calculate RL score impact from upgrade
+     * Positive impact if upgrade improves capability
+     */
+    calculateRLScoreImpact(preUpgrade: RLUpgradeContext, postUpgradeSuccess: boolean): number;
+    /**
+     * Upgrade with build verification
+     */
+    upgradeWithBuildCheck(version?: string, buildCommand?: string): Promise<UpgradeResult & {
+        buildSuccess: boolean;
+    }>;
+    /**
+     * Upgrade with test verification
+     */
+    upgradeWithTestCheck(version?: string, testCommand?: string): Promise<UpgradeResult & {
+        testState: TestState;
+    }>;
+    /**
+     * Full upgrade with build and test verification
+     */
+    upgradeWithFullVerification(version?: string, buildCommand?: string, testCommand?: string): Promise<UpgradeResult & {
+        buildSuccess: boolean;
+        testState: TestState;
+    }>;
+    private parseTestCount;
+    /**
+     * Save active edits before upgrade for continuity
+     */
+    saveActiveEdits(files: string[]): void;
+    /**
+     * Get active edits to resume after upgrade
+     */
+    getActiveEdits(): string[];
+    private logUpgrade;
+    private emitEvent;
+    /**
+     * Check if this process was started after an upgrade
+     */
+    static wasUpgraded(): boolean;
+    /**
+     * Get the version we upgraded from
+     */
+    static getUpgradeFromVersion(): string | null;
+    /**
+     * Check if we should resume a session
+     */
+    static shouldResumeSession(): boolean;
+}
+export declare function getSelfUpgrade(config?: SelfUpgradeConfig): SelfUpgrade;
+export declare function resetSelfUpgrade(): void;
+/**
+ * Quick upgrade to latest version with session continuity
+ */
+export declare function upgradeToLatest(options?: {
+    autoRestart?: boolean;
+    workingDir?: string;
+    logger?: (message: string) => void;
+}): Promise<UpgradeResult>;
+/**
+ * Upgrade with full verification (build + tests)
+ */
+export declare function upgradeAndVerify(options?: {
+    version?: string;
+    buildCommand?: string;
+    testCommand?: string;
+    workingDir?: string;
+    logger?: (message: string) => void;
+}): Promise<UpgradeResult & {
+    buildSuccess: boolean;
+    testState: TestState;
+}>;
+/**
+ * Save current work state for upgrade resumption
+ */
+export declare function saveUpgradeState(state: Omit<UpgradeSessionState, 'timestamp' | 'fromVersion'>): void;
+/**
+ * Resume work after upgrade
+ */
+export declare function resumeAfterUpgrade(): UpgradeSessionState | null;
+//# sourceMappingURL=selfUpgrade.d.ts.map

package/dist/core/selfUpgrade.d.ts.map

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