@nexus-cortex/executors 4.26.0

package/dist/implementations/addon/CreateArtifactTool.d.ts

@@ -0,0 +1,221 @@
+import { BaseTool } from '../../base/BaseTool.js';
+import type { ToolResult } from '../../base/ToolResult.js';
+import { ChildProcess } from 'child_process';
+import { VisualSnapshot } from './VisualFeedbackBridge.js';
+/**
+ * Package manager types
+ */
+type PackageManager = 'npm' | 'pip' | 'uv' | 'nix';
+/**
+ * Artifact mode
+ */
+type ArtifactMode = 'oneshot' | 'dev' | 'persistent';
+/**
+ * Running artifact session
+ */
+interface ArtifactSession {
+    id: string;
+    name: string;
+    process?: ChildProcess;
+    tmuxSessionId?: string;
+    url?: string;
+    port?: number;
+    mode: ArtifactMode;
+    startTime: Date;
+    lastActivity: Date;
+    watchers?: any[];
+    visualSnapshot?: VisualSnapshot;
+    path?: string;
+}
+/**
+ * Parameters for CreateArtifactTool
+ */
+export interface CreateArtifactToolParams {
+    name: string;
+    description: string;
+    parameters: Record<string, any>;
+    implementation: {
+        language: 'javascript' | 'python' | 'rust' | 'go' | 'shell' | 'html' | 'other';
+        code: string;
+        fileName?: string;
+        entryPoint?: string;
+        command?: string;
+        buildCommand?: string;
+        dependencies?: string[];
+        packageManager?: PackageManager;
+    };
+    mode?: ArtifactMode;
+    persistent?: boolean;
+    enableVisualFeedback?: boolean;
+    enableReactIntrospection?: boolean;
+    devConfig?: {
+        hotReload?: boolean;
+        watchFiles?: string[];
+        openBrowser?: boolean;
+        liveBridge?: boolean;
+    };
+    uiConfig?: {
+        type?: 'web' | 'terminal' | 'both';
+        framework?: 'express' | 'fastapi' | 'flask' | 'nextjs' | 'react';
+        reactMode?: 'cdn' | 'bundled';
+        additionalFiles?: Array<{
+            path: string;
+            code: string;
+        }>;
+        autoStart?: boolean;
+    };
+    testCases?: Array<{
+        input: Record<string, any>;
+        expectedOutput?: Record<string, any>;
+    }>;
+    artifactConfig?: {
+        type?: 'docker' | 'local' | 'nix';
+        image?: string;
+        ports?: number[];
+        volumes?: Record<string, string>;
+        env?: Record<string, string>;
+        nixConfig?: {
+            packages?: string[];
+            shellHook?: string;
+        };
+    };
+}
+/**
+ * CreateAddonToolEnhanced - Next-generation dynamic tool creation
+ *
+ * Features:
+ * - UV + NIX package manager support
+ * - Dev mode with hot reloading
+ * - Automatic UI display (browser popup)
+ * - Persistent artifact sessions
+ * - Live editing with file watching
+ * - Multi-step orchestration
+ * - WebSocket live updates
+ *
+ * Example: TradeStation Proxy
+ * ```
+ * Model creates:
+ * 1. Proxy server (Express.js)
+ * 2. Traffic monitor (captures inbound/outbound)
+ * 3. Real-time dashboard (React/Socket.io)
+ * 4. Auto-opens browser at localhost:3000
+ * 5. Hot reloads on code changes
+ * ```
+ */
+export declare class CreateArtifactToolExecutor extends BaseTool<CreateArtifactToolParams, ToolResult> {
+    private artifactDir;
+    private workingDirectory;
+    constructor(config: {
+        workingDirectory: string;
+    });
+    /**
+     * Sanitize name to filesystem-safe format (kebab-case slug)
+     * Industry best practice: Accept human-friendly input, auto-convert to system-safe format
+     */
+    private sanitizeName;
+    validateToolParams(params: CreateArtifactToolParams): string | null;
+    execute(params: CreateArtifactToolParams, signal: AbortSignal): Promise<ToolResult>;
+    /**
+     * Install dependencies using specified package manager
+     */
+    private installDependencies;
+    /**
+     * Install with npm
+     */
+    private installNpm;
+    /**
+     * Install with pip
+     */
+    private installPip;
+    /**
+     * Install with UV (fast Python package manager)
+     */
+    private installUv;
+    /**
+     * Setup Nix environment
+     */
+    private setupNix;
+    /**
+     * Write tool files to artifact
+     */
+    private writeToolFiles;
+    /**
+     * Wrap user code with web framework boilerplate
+     */
+    private wrapWithFramework;
+    /**
+     * Find an available port starting from a base port
+     */
+    private findAvailablePort;
+    /**
+     * Launch persistent artifact with tmux integration
+     * Supports arbitrary languages and custom commands
+     */
+    private launchPersistentArtifact;
+    /**
+     * Setup hot reload with file watching
+     */
+    private setupHotReload;
+    /**
+     * Initialize visual feedback bridge
+     */
+    private initializeVisualFeedback;
+    /**
+     * Open browser automatically
+     */
+    private openBrowser;
+    /**
+     * Execute tool in oneshot mode
+     */
+    private executeOneshot;
+    /**
+     * Run command and capture output
+     */
+    private runCommand;
+    /**
+     * Format output for persistent/dev artifact
+     */
+    private formatPersistentOutput;
+    /**
+     * Get active artifact by ID
+     */
+    static getActiveArtifact(id: string): ArtifactSession | undefined;
+    /**
+     * List all active artifactes
+     */
+    static listActiveArtifactes(): ArtifactSession[];
+    /**
+     * Get all active artifactes (alias for listActiveArtifactes)
+     */
+    static getActiveArtifactes(): ArtifactSession[];
+    /**
+     * Stop a artifact
+     */
+    static stopArtifact(id: string): boolean;
+    /**
+     * Get visual snapshot for a artifact
+     */
+    static getVisualSnapshot(id: string): VisualSnapshot | undefined;
+    /**
+     * Capture fresh visual snapshot for a running artifact
+     */
+    static refreshVisualSnapshot(id: string): Promise<VisualSnapshot | null>;
+    /**
+     * @deprecated Use getActiveArtifact instead
+     */
+    static getActiveSandbox(id: string): ArtifactSession | undefined;
+    /**
+     * @deprecated Use listActiveArtifactes instead
+     */
+    static getActiveSandboxes(): ArtifactSession[];
+    /**
+     * @deprecated Use listActiveArtifactes instead
+     */
+    static listActiveSandboxes(): ArtifactSession[];
+    /**
+     * @deprecated Use stopArtifact instead
+     */
+    static stopSandbox(id: string): boolean;
+}
+export {};
+//# sourceMappingURL=CreateArtifactTool.d.ts.map

package/dist/implementations/addon/CreateArtifactTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateArtifactTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/addon/CreateArtifactTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAS,YAAY,EAAE,MAAM,eAAe,CAAC;AAQpD,OAAO,EAAgB,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAUzE;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;AAEnD;;GAEG;AACH,KAAK,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;AAErD;;GAEG;AACH,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEhC,cAAc,EAAE;QACd,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;QAC/E,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC,CAAC;IAEF,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC,SAAS,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;IAEF,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;QACnC,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;QACjE,SAAS,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;QAC9B,eAAe,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxD,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;IAEF,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACtC,CAAC,CAAC;IAEH,cAAc,CAAC,EAAE;QACf,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,SAAS,CAAC,EAAE;YACV,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAOD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,0BAA2B,SAAQ,QAAQ,CAAC,wBAAwB,EAAE,UAAU,CAAC;IAC5F,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAoKhD;;;OAGG;IACH,OAAO,CAAC,YAAY;IAUpB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI;IAoD7D,OAAO,CAAC,MAAM,EAAE,wBAAwB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAqGzF;;OAEG;YACW,mBAAmB;IA6BjC;;OAEG;YACW,UAAU;IAexB;;OAEG;YACW,UAAU;IASxB;;OAEG;YACW,SAAS;IAiBvB;;OAEG;YACW,QAAQ;IAoBtB;;OAEG;YACW,cAAc;IAyE5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiFzB;;OAEG;YACW,iBAAiB;IA0B/B;;;OAGG;YACW,wBAAwB;IA2MtC;;OAEG;YACW,cAAc;IA2D5B;;OAEG;YACW,wBAAwB;IAgCtC;;OAEG;YACW,WAAW;IAoBzB;;OAEG;YACW,cAAc;IAgB5B;;OAEG;YACW,UAAU;IA8BxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+E9B;;OAEG;WACW,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIxE;;OAEG;WACW,oBAAoB,IAAI,eAAe,EAAE;IAIvD;;OAEG;WACW,mBAAmB,IAAI,eAAe,EAAE;IAItD;;OAEG;WACW,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAW/C;;OAEG;WACW,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKvE;;OAEG;WACiB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAerF;;OAEG;WACW,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIvE;;OAEG;WACW,kBAAkB,IAAI,eAAe,EAAE;IAIrD;;OAEG;WACW,mBAAmB,IAAI,eAAe,EAAE;IAItD;;OAEG;WACW,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAG/C"}