@nexus-cortex/executors 4.26.0

package/dist/utils/ArtifactRegistry.d.ts

@@ -0,0 +1,138 @@
+/**
+ * ArtifactRegistry - Unified registry for all artifacts and sessions
+ *
+ * Consolidates the previous split between:
+ * - SandboxRegistry (.addon-tools/registry.json)
+ * - SessionPersistence (.cortex/tmux-sessions/metadata/)
+ *
+ * New unified structure:
+ * .cortex/
+ * └── artifacts/
+ *     ├── registry.json             # Master registry
+ *     └── <artifact-id>/            # One directory per artifact
+ *         ├── metadata.json         # Type, runtime, ports, etc.
+ *         ├── workspace/            # Code files
+ *         ├── tmux/                 # Tmux-specific data (if applicable)
+ *         └── snapshots/            # Historical captures
+ */
+export type ArtifactType = 'web-app' | 'cli-tool' | 'script' | 'service';
+export type ArtifactRuntime = 'tmux+node' | 'tmux+python' | 'tmux+http-server' | 'tmux+rust' | 'tmux+go' | 'tmux+shell' | 'tmux+custom' | 'tmux+other' | 'process' | 'docker';
+export type ArtifactMode = 'oneshot' | 'dev' | 'persistent';
+/**
+ * Unified artifact metadata (combines sandbox + tmux session info)
+ */
+export interface ArtifactMetadata {
+    id: string;
+    name: string;
+    type: ArtifactType;
+    runtime: ArtifactRuntime;
+    created: string;
+    lastUsed: string;
+    workspaceDir: string;
+    entryPoint?: string;
+    mode: ArtifactMode;
+    port?: number;
+    url?: string;
+    pid?: number;
+    tmuxSession?: string;
+    description?: string;
+    tags?: string[];
+    env?: Record<string, string>;
+    metadata?: Record<string, any>;
+}
+/**
+ * Master registry schema (v2.0.0)
+ */
+export interface ArtifactRegistrySchema {
+    version: '2.0.0';
+    artifacts: Record<string, ArtifactMetadata>;
+}
+/**
+ * ArtifactRegistry - Singleton for unified artifact/session management
+ */
+export declare class ArtifactRegistry {
+    private static instance;
+    private registryPath;
+    private artifactsDir;
+    private registry;
+    private initialized;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(projectRoot: string): ArtifactRegistry;
+    /**
+     * Initialize registry (load from disk or create)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Register a new artifact
+     */
+    register(metadata: ArtifactMetadata): Promise<void>;
+    /**
+     * Update artifact metadata
+     */
+    update(id: string, updates: Partial<ArtifactMetadata>): Promise<void>;
+    /**
+     * Get artifact by ID
+     */
+    get(id: string): Promise<ArtifactMetadata | null>;
+    /**
+     * List all artifacts
+     */
+    list(): Promise<ArtifactMetadata[]>;
+    /**
+     * Remove artifact
+     */
+    remove(id: string): Promise<void>;
+    /**
+     * Get artifact workspace directory
+     */
+    getWorkspaceDir(id: string): string;
+    /**
+     * Get artifact tmux directory
+     */
+    getTmuxDir(id: string): string;
+    /**
+     * Get artifact snapshots directory
+     */
+    getSnapshotsDir(id: string): string;
+    /**
+     * Save registry to disk
+     */
+    private save;
+    /**
+     * Migrate from old registry format
+     */
+    private migrateRegistry;
+    /**
+     * Find artifacts by type
+     */
+    findByType(type: ArtifactType): Promise<ArtifactMetadata[]>;
+    /**
+     * Find artifacts by runtime
+     */
+    findByRuntime(runtime: ArtifactRuntime): Promise<ArtifactMetadata[]>;
+    /**
+     * Find artifact by tmux session ID
+     */
+    findByTmuxSession(sessionId: string): Promise<ArtifactMetadata | null>;
+    /**
+     * Get all ports currently in use by artifacts
+     */
+    getUsedPorts(): number[];
+    /**
+     * Get all artifacts (synchronous version for use in registry queries)
+     */
+    getAll(): ArtifactMetadata[];
+    /**
+     * Get registry statistics
+     */
+    getStats(): Promise<{
+        total: number;
+        byType: Record<ArtifactType, number>;
+        byRuntime: Record<ArtifactRuntime, number>;
+        byMode: Record<ArtifactMode, number>;
+    }>;
+}
+//# sourceMappingURL=ArtifactRegistry.d.ts.map

package/dist/utils/ArtifactRegistry.d.ts.map

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

package/dist/utils/ArtifactRegistry.js

@@ -0,0 +1,259 @@
+/**
+ * ArtifactRegistry - Unified registry for all artifacts and sessions
+ *
+ * Consolidates the previous split between:
+ * - SandboxRegistry (.addon-tools/registry.json)
+ * - SessionPersistence (.cortex/tmux-sessions/metadata/)
+ *
+ * New unified structure:
+ * .cortex/
+ * └── artifacts/
+ *     ├── registry.json             # Master registry
+ *     └── <artifact-id>/            # One directory per artifact
+ *         ├── metadata.json         # Type, runtime, ports, etc.
+ *         ├── workspace/            # Code files
+ *         ├── tmux/                 # Tmux-specific data (if applicable)
+ *         └── snapshots/            # Historical captures
+ */
+import { promises as fs } from 'fs';
+import { join } from 'path';
+/**
+ * ArtifactRegistry - Singleton for unified artifact/session management
+ */
+export class ArtifactRegistry {
+    static instance;
+    registryPath;
+    artifactsDir;
+    registry;
+    initialized = false;
+    constructor(projectRoot) {
+        this.artifactsDir = join(projectRoot, '.cortex', 'artifacts');
+        this.registryPath = join(this.artifactsDir, 'registry.json');
+        this.registry = {
+            version: '2.0.0',
+            artifacts: {}
+        };
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance(projectRoot) {
+        if (!ArtifactRegistry.instance) {
+            ArtifactRegistry.instance = new ArtifactRegistry(projectRoot);
+        }
+        return ArtifactRegistry.instance;
+    }
+    /**
+     * Initialize registry (load from disk or create)
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            // Ensure artifacts directory exists
+            await fs.mkdir(this.artifactsDir, { recursive: true });
+            // Load existing registry or create new
+            try {
+                const content = await fs.readFile(this.registryPath, 'utf-8');
+                this.registry = JSON.parse(content);
+                // Validate version
+                if (this.registry.version !== '2.0.0') {
+                    console.warn(`⚠  Registry version mismatch: ${this.registry.version}. Migrating to 2.0.0...`);
+                    await this.migrateRegistry();
+                }
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    // No registry exists, start fresh. Log to stderr (not stdout) with a
+                    // text label — stdout must stay clean for --json consumers (e.g. the
+                    // auto-research Fixer parsing `cortex autoresearch fix --json`), and
+                    // no emojis in production output.
+                    await this.save();
+                    console.error(`[INIT] Created new artifact registry at ${this.registryPath}`);
+                }
+                else {
+                    throw error;
+                }
+            }
+            this.initialized = true;
+        }
+        catch (error) {
+            console.error(`Failed to initialize ArtifactRegistry: ${error.message}`);
+            throw error;
+        }
+    }
+    /**
+     * Register a new artifact
+     */
+    async register(metadata) {
+        if (!this.initialized)
+            await this.initialize();
+        // Create artifact directory structure
+        const artifactDir = join(this.artifactsDir, metadata.id);
+        await fs.mkdir(artifactDir, { recursive: true });
+        await fs.mkdir(join(artifactDir, 'workspace'), { recursive: true });
+        if (metadata.tmuxSession) {
+            await fs.mkdir(join(artifactDir, 'tmux'), { recursive: true });
+        }
+        await fs.mkdir(join(artifactDir, 'snapshots'), { recursive: true });
+        // Write metadata file
+        await fs.writeFile(join(artifactDir, 'metadata.json'), JSON.stringify(metadata, null, 2));
+        // Add to registry
+        this.registry.artifacts[metadata.id] = metadata;
+        await this.save();
+    }
+    /**
+     * Update artifact metadata
+     */
+    async update(id, updates) {
+        if (!this.initialized)
+            await this.initialize();
+        const artifact = this.registry.artifacts[id];
+        if (!artifact) {
+            throw new Error(`Artifact not found: ${id}`);
+        }
+        // Merge updates
+        Object.assign(artifact, updates);
+        artifact.lastUsed = new Date().toISOString();
+        // Update metadata file
+        const artifactDir = join(this.artifactsDir, id);
+        await fs.writeFile(join(artifactDir, 'metadata.json'), JSON.stringify(artifact, null, 2));
+        // Update registry
+        this.registry.artifacts[id] = artifact;
+        await this.save();
+    }
+    /**
+     * Get artifact by ID
+     */
+    async get(id) {
+        if (!this.initialized)
+            await this.initialize();
+        return this.registry.artifacts[id] || null;
+    }
+    /**
+     * List all artifacts
+     */
+    async list() {
+        if (!this.initialized)
+            await this.initialize();
+        return Object.values(this.registry.artifacts);
+    }
+    /**
+     * Remove artifact
+     */
+    async remove(id) {
+        if (!this.initialized)
+            await this.initialize();
+        const artifact = this.registry.artifacts[id];
+        if (!artifact)
+            return;
+        // Remove artifact directory
+        const artifactDir = join(this.artifactsDir, id);
+        await fs.rm(artifactDir, { recursive: true, force: true });
+        // Remove from registry
+        delete this.registry.artifacts[id];
+        await this.save();
+    }
+    /**
+     * Get artifact workspace directory
+     */
+    getWorkspaceDir(id) {
+        return join(this.artifactsDir, id, 'workspace');
+    }
+    /**
+     * Get artifact tmux directory
+     */
+    getTmuxDir(id) {
+        return join(this.artifactsDir, id, 'tmux');
+    }
+    /**
+     * Get artifact snapshots directory
+     */
+    getSnapshotsDir(id) {
+        return join(this.artifactsDir, id, 'snapshots');
+    }
+    /**
+     * Save registry to disk
+     */
+    async save() {
+        await fs.writeFile(this.registryPath, JSON.stringify(this.registry, null, 2));
+    }
+    /**
+     * Migrate from old registry format
+     */
+    async migrateRegistry() {
+        // This will handle migration from v1.0.0 (SandboxRegistry) format
+        // For now, just reset to v2.0.0
+        console.log('Performing registry migration...');
+        this.registry = {
+            version: '2.0.0',
+            artifacts: {}
+        };
+        await this.save();
+        console.log('[OK] Registry migration complete');
+    }
+    /**
+     * Find artifacts by type
+     */
+    async findByType(type) {
+        if (!this.initialized)
+            await this.initialize();
+        return Object.values(this.registry.artifacts).filter(a => a.type === type);
+    }
+    /**
+     * Find artifacts by runtime
+     */
+    async findByRuntime(runtime) {
+        if (!this.initialized)
+            await this.initialize();
+        return Object.values(this.registry.artifacts).filter(a => a.runtime === runtime);
+    }
+    /**
+     * Find artifact by tmux session ID
+     */
+    async findByTmuxSession(sessionId) {
+        if (!this.initialized)
+            await this.initialize();
+        const artifacts = Object.values(this.registry.artifacts);
+        return artifacts.find(a => a.tmuxSession === sessionId) || null;
+    }
+    /**
+     * Get all ports currently in use by artifacts
+     */
+    getUsedPorts() {
+        const ports = [];
+        for (const artifact of Object.values(this.registry.artifacts)) {
+            if (artifact.port) {
+                ports.push(artifact.port);
+            }
+        }
+        return ports;
+    }
+    /**
+     * Get all artifacts (synchronous version for use in registry queries)
+     */
+    getAll() {
+        return Object.values(this.registry.artifacts);
+    }
+    /**
+     * Get registry statistics
+     */
+    async getStats() {
+        if (!this.initialized)
+            await this.initialize();
+        const artifacts = Object.values(this.registry.artifacts);
+        const stats = {
+            total: artifacts.length,
+            byType: {},
+            byRuntime: {},
+            byMode: {}
+        };
+        artifacts.forEach(a => {
+            stats.byType[a.type] = (stats.byType[a.type] || 0) + 1;
+            stats.byRuntime[a.runtime] = (stats.byRuntime[a.runtime] || 0) + 1;
+            stats.byMode[a.mode] = (stats.byMode[a.mode] || 0) + 1;
+        });
+        return stats;
+    }
+}
+//# sourceMappingURL=ArtifactRegistry.js.map

package/dist/utils/ArtifactRegistry.js.map

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

package/dist/utils/ChromiumBrowserManager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * ChromiumBinaryLocator - Robust chromium binary discovery
+ * Searches multiple locations with priority order and validation
+ */
+declare class ChromiumBinaryLocator {
+    private cachedPath;
+    /**
+     * Find chromium binary with comprehensive search
+     */
+    private findBinary;
+    /**
+     * Search nix store for chromium binaries
+     */
+    private findChromiumInNixStore;
+    /**
+     * Find chromium in Playwright's cache directory
+     */
+    private findPlaywrightCachedChromium;
+    /**
+     * Check if path is an executable file
+     */
+    private isExecutable;
+    /**
+     * Get chromium binary path (cached)
+     */
+    getBinary(): string | null;
+    /**
+     * Clear cached path (for testing)
+     */
+    clearCache(): void;
+    /**
+     * Get browser configuration for Playwright
+     */
+    getPlaywrightConfig(): {
+        executablePath?: string;
+    };
+}
+/**
+ * Get chromium binary path
+ */
+export declare function getChromiumBinary(): string | null;
+/**
+ * Get Playwright browser launch configuration
+ */
+export declare function getPlaywrightConfig(): {
+    executablePath?: string;
+};
+/**
+ * Clear cached chromium path (for testing)
+ */
+export declare function clearChromiumCache(): void;
+/**
+ * Export the locator class for advanced usage
+ */
+export { ChromiumBinaryLocator };
+//# sourceMappingURL=ChromiumBrowserManager.d.ts.map

package/dist/utils/ChromiumBrowserManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromiumBrowserManager.d.ts","sourceRoot":"","sources":["../../src/utils/ChromiumBrowserManager.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,cAAM,qBAAqB;IACzB,OAAO,CAAC,UAAU,CAAwC;IAE1D;;OAEG;IACH,OAAO,CAAC,UAAU;IAkGlB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6B9B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA+CpC;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACI,SAAS,IAAI,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACI,UAAU,IAAI,IAAI;IAIzB;;OAEG;IACI,mBAAmB,IAAI;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE;CAS1D;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAEjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,CAAC"}