@nexus-ai-nexoralabs/cli 0.1.0

package/dist/main.js

@@ -0,0 +1,113 @@
+import { ConfigService } from './config/index.js';
+import { ApplicationApi } from './api/index.js';
+import { UIServer } from './ui/server.js';
+import { Logger } from './common/logger.js';
+function checkIcon(status) {
+    switch (status) {
+        case 'OK': return 'OK  ';
+        case 'DEGRADED': return 'WARN';
+        case 'FAIL': return 'FAIL';
+        case 'SKIP': return 'SKIP';
+    }
+}
+function printFirstRunReport(report) {
+    console.log('\n====================================================');
+    console.log(' NEXUS AI — SYSTEM HEALTH CHECK');
+    console.log('====================================================');
+    for (const check of report.checks) {
+        const icon = checkIcon(check.status);
+        const detail = check.detail ? `  ${check.detail}` : '';
+        console.log(`  [${icon}]  ${check.name}${detail}`);
+        if ((check.status === 'FAIL' || check.status === 'DEGRADED') && check.action) {
+            console.log(`         Action: ${check.action}`);
+        }
+    }
+    console.log('');
+    const stateLabel = report.state;
+    const isReady = stateLabel === 'READY' || stateLabel === 'CONFIGURED' || stateLabel === 'FIRST_RUN';
+    console.log(`System Status: ${stateLabel}${isReady ? '' : ' — some subsystems require attention'}`);
+    console.log('====================================================\n');
+}
+async function main() {
+    console.log('====================================================');
+    console.log(' NEXUS AI — Local-First Windows Workstation Shell  ');
+    console.log('====================================================');
+    const configService = new ConfigService();
+    const config = configService.getConfig();
+    const logger = new Logger('Main', config.logLevel);
+    logger.info(`Bootstrapping application shell in [${config.environment}] mode`);
+    const appApi = new ApplicationApi(config);
+    let uiServer = null;
+    const shutdown = async (signal) => {
+        logger.info(`Shutdown signal '${signal}' received. Closing subsystems cleanly...`);
+        try {
+            if (uiServer) {
+                await uiServer.stop();
+            }
+            appApi.close();
+        }
+        catch (err) {
+            logger.error(`Error during graceful shutdown: ${String(err)}`);
+        }
+    };
+    process.on('SIGINT', () => {
+        shutdown('SIGINT').then(() => process.exit(0));
+    });
+    process.on('SIGTERM', () => {
+        shutdown('SIGTERM').then(() => process.exit(0));
+    });
+    process.on('uncaughtException', (err) => {
+        logger.error('Uncaught Exception detected', { error: err.message });
+        shutdown('uncaughtException').then(() => process.exit(1));
+    });
+    process.on('unhandledRejection', (reason) => {
+        logger.error('Unhandled Promise Rejection detected', { reason: String(reason) });
+        shutdown('unhandledRejection').then(() => process.exit(1));
+    });
+    await appApi.bootstrap();
+    // Start Desktop UI Server
+    uiServer = new UIServer(appApi, config.port, config.logLevel);
+    const listeningPort = await uiServer.start();
+    console.log(`\n💻 NEXUS Desktop UI is live at: http://127.0.0.1:${listeningPort}`);
+    // First-run health check with formatted diagnostics
+    try {
+        const report = await appApi.getFirstRunReport();
+        if (report) {
+            printFirstRunReport(report);
+        }
+    }
+    catch (err) {
+        logger.warn(`First-run health check failed: ${String(err)}. Falling back to raw status.`);
+        const health = appApi.getHealthReport();
+        console.log(`\n[Status] System Overall Health: ${health.overall.toUpperCase()}`);
+        console.log('[Status] Subsystem Status Breakdown:');
+        for (const subsystem of health.subsystems) {
+            console.log(`  - ${subsystem.name}: [${subsystem.status.toUpperCase()}] ${subsystem.message}`);
+        }
+    }
+    // Smoke test if Ollama is available
+    const intelStatus = appApi.intelligence.getStatus();
+    if (intelStatus?.details?.ollamaAvailable) {
+        console.log('[RAG Smoke Test] Ingesting test document into default knowledge collection...');
+        const defaultCol = appApi.knowledge.rag.getOrCreateDefaultCollection();
+        const sampleDocText = '# NEXUS AI Architecture Overview\n' +
+            'The NEXUS AI Orchestrator connects local language models, vector knowledge search, and permission-controlled tools.\n' +
+            'All processing runs offline on the user device.';
+        const ingestedDoc = await appApi.knowledge.rag.ingestText('nexus_architecture_overview.md', sampleDocText, defaultCol.id);
+        console.log(`[RAG Smoke Test] Ingested document '${ingestedDoc.filename}' (ID: ${ingestedDoc.id}, Version: ${ingestedDoc.currentVersion})`);
+    }
+    else {
+        console.log('[Smoke Test Skipped] Ollama service is offline.');
+    }
+    console.log('\n[NEXUS AI] Phase P7-D Desktop UI/UX Station Active.');
+    // Standalone startup stays alive or closes cleanly depending on process context
+    if (process.env.NODE_ENV === 'test') {
+        await uiServer.stop();
+        appApi.close();
+    }
+}
+main().catch((err) => {
+    console.error('[NEXUS AI] Fatal Startup Error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/orchestration/agentExecutionService.d.ts

@@ -0,0 +1,29 @@
+import type { AgentTaskService } from './agentTaskService.js';
+import type { AgentTask } from '../storage/repositories/types.js';
+import type { ToolGateway } from '../tools/index.js';
+import type { AgentPlanStep, ExecutionLoopOptions } from './types.js';
+import { LogLevel } from '../common/logger.js';
+import type { HumanApprovalService } from './humanApprovalService.js';
+export declare class AgentExecutionService {
+    private taskService;
+    private toolGateway;
+    private logger;
+    private approvalService?;
+    constructor(taskService: AgentTaskService, toolGateway: ToolGateway, approvalServiceOrLogLevel?: HumanApprovalService | LogLevel, logLevel?: LogLevel);
+    /**
+     * Execute a sequence of plan steps within a controlled, bounded, and deterministic execution loop.
+     *
+     * Lifecycle:
+     * TASK -> PLANNING -> STEP CREATED -> TOOL REQUEST -> AUTHORIZATION -> EXECUTION -> OBSERVATION -> VERIFICATION -> COMPLETE
+     */
+    runExecutionLoop(taskId: string, steps: AgentPlanStep[], options?: ExecutionLoopOptions): Promise<AgentTask>;
+    /**
+     * Cancel execution of a task.
+     */
+    cancelExecution(taskId: string): AgentTask;
+    /**
+     * Helper to execute tool with a strict timeout boundary.
+     */
+    private executeWithTimeout;
+}
+//# sourceMappingURL=agentExecutionService.d.ts.map

package/dist/orchestration/agentExecutionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentExecutionService.d.ts","sourceRoot":"","sources":["../../src/orchestration/agentExecutionService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EACV,aAAa,EAGb,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,qBAAa,qBAAqB;IAK9B,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IALrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAC,CAAuB;gBAGrC,WAAW,EAAE,gBAAgB,EAC7B,WAAW,EAAE,WAAW,EAChC,yBAAyB,CAAC,EAAE,oBAAoB,GAAG,QAAQ,EAC3D,QAAQ,GAAE,QAAiB;IAW7B;;;;;OAKG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,SAAS,CAAC;IAmRrB;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAK1C;;OAEG;YACW,kBAAkB;CA+BjC"}

package/dist/orchestration/agentExecutionService.js

@@ -0,0 +1,306 @@
+import { NON_RETRYABLE_ERROR_CATEGORIES } from './types.js';
+import { AgentStateMachine } from './agentStateMachine.js';
+import { Logger } from '../common/logger.js';
+import { GoalCompletionVerifier } from './goalCompletionVerifier.js';
+export class AgentExecutionService {
+    taskService;
+    toolGateway;
+    logger;
+    approvalService;
+    constructor(taskService, toolGateway, approvalServiceOrLogLevel, logLevel = 'info') {
+        this.taskService = taskService;
+        this.toolGateway = toolGateway;
+        if (typeof approvalServiceOrLogLevel === 'string') {
+            this.approvalService = undefined;
+            this.logger = new Logger('AgentExecutionService', approvalServiceOrLogLevel);
+        }
+        else {
+            this.approvalService = approvalServiceOrLogLevel;
+            this.logger = new Logger('AgentExecutionService', logLevel);
+        }
+    }
+    /**
+     * Execute a sequence of plan steps within a controlled, bounded, and deterministic execution loop.
+     *
+     * Lifecycle:
+     * TASK -> PLANNING -> STEP CREATED -> TOOL REQUEST -> AUTHORIZATION -> EXECUTION -> OBSERVATION -> VERIFICATION -> COMPLETE
+     */
+    async runExecutionLoop(taskId, steps, options = {}) {
+        const maxSteps = options.maxSteps ?? 10;
+        const defaultMaxAttempts = options.maxAttemptsPerStep ?? 3;
+        const timeoutMs = options.stepTimeoutMs ?? 5000;
+        let task = this.taskService.getTask(taskId);
+        // 1. Initial State Check — verify task is not already terminal
+        if (AgentStateMachine.isTerminal(task.state)) {
+            this.logger.warn(`Execution loop rejected: task is in terminal state '${task.state}'`, { taskId });
+            return task;
+        }
+        // Move task to planning state if created
+        if (task.state === 'created') {
+            task = this.taskService.transitionTask(taskId, { targetState: 'planning' });
+        }
+        this.logger.info(`Starting execution loop`, {
+            taskId,
+            stepCount: steps.length,
+            maxSteps,
+        });
+        let completedStepCount = 0;
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            // Re-fetch fresh task state before step
+            task = this.taskService.getTask(taskId);
+            if (AgentStateMachine.isTerminal(task.state)) {
+                this.logger.info(`Execution loop halted: task became terminal ('${task.state}')`, { taskId });
+                return task;
+            }
+            // Step limit check
+            if (completedStepCount >= maxSteps) {
+                this.logger.error(`Execution loop halted: maximum step limit reached`, {
+                    taskId,
+                    completedStepCount,
+                    maxSteps,
+                });
+                return this.taskService.failTask(taskId, {
+                    errorCategory: 'STEP_LIMIT_EXCEEDED',
+                    currentStep: step.stepId,
+                });
+            }
+            // Human Approval Gate Check (P5-F)
+            if (this.approvalService) {
+                const toolId = step.toolId || 'unknown_tool';
+                const capability = step.requestedCapabilities?.[0] || 'filesystem.read';
+                let approval = this.approvalService.getApprovalsForTask(taskId).find((a) => a.stepId === step.stepId);
+                if (!approval) {
+                    const created = this.approvalService.createApprovalRequest({
+                        taskId,
+                        stepId: step.stepId,
+                        toolId,
+                        requestedCapability: capability,
+                    });
+                    approval = created.approval;
+                }
+                const gateResult = this.approvalService.evaluateGateForStep(taskId, step.stepId);
+                if (!gateResult.allowed) {
+                    if (gateResult.status === 'pending') {
+                        this.logger.info(`Step '${step.stepId}' requires human approval. Execution loop paused.`, { taskId, stepId: step.stepId });
+                        return this.taskService.getTask(taskId);
+                    }
+                    if (gateResult.status === 'rejected') {
+                        this.logger.warn(`Step '${step.stepId}' human approval was rejected. Halting execution.`, { taskId, stepId: step.stepId });
+                        return this.taskService.failTask(taskId, {
+                            errorCategory: 'APPROVAL_REJECTED',
+                            currentStep: step.stepId,
+                        });
+                    }
+                    if (gateResult.status === 'expired') {
+                        this.logger.warn(`Step '${step.stepId}' human approval expired. Halting execution.`, { taskId, stepId: step.stepId });
+                        return this.taskService.failTask(taskId, {
+                            errorCategory: 'APPROVAL_EXPIRED',
+                            currentStep: step.stepId,
+                        });
+                    }
+                    if (gateResult.status === 'cancelled') {
+                        this.logger.warn(`Step '${step.stepId}' human approval was cancelled. Halting execution.`, { taskId, stepId: step.stepId });
+                        return this.taskService.getTask(taskId);
+                    }
+                }
+            }
+            // Move task to executing state
+            if (task.state !== 'executing') {
+                task = this.taskService.transitionTask(taskId, {
+                    targetState: 'executing',
+                    currentStep: step.stepId,
+                });
+            }
+            const maxAttempts = step.maxAttempts || defaultMaxAttempts;
+            let stepSuccess = false;
+            let lastResult = null;
+            let lastErrorCategory = 'STEP_FAILED';
+            // Bounded Attempt Retry Loop
+            for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+                // Re-check cancellation before starting attempt
+                task = this.taskService.getTask(taskId);
+                if (task.state === 'cancelled' || AgentStateMachine.isTerminal(task.state)) {
+                    this.logger.info(`Attempt ${attempt} cancelled: task state is '${task.state}'`, { taskId });
+                    return task;
+                }
+                step.attemptCount = attempt;
+                const requestId = `req-${taskId}-${step.stepId}-att${attempt}`;
+                const startTime = Date.now();
+                this.logger.info(`Executing step attempt ${attempt}/${maxAttempts}`, {
+                    taskId,
+                    stepId: step.stepId,
+                    requestId,
+                    toolId: step.toolId,
+                });
+                // Prepare tool execution request
+                const execRequest = {
+                    requestId,
+                    taskId,
+                    toolId: step.toolId || 'unknown_tool',
+                    requestedCapabilities: step.requestedCapabilities || [],
+                    params: step.params || {},
+                };
+                // Execute tool with timeout protection
+                let result;
+                try {
+                    result = await this.executeWithTimeout(execRequest, timeoutMs);
+                }
+                catch (err) {
+                    result = {
+                        requestId,
+                        taskId,
+                        toolId: step.toolId || 'unknown_tool',
+                        authorized: true,
+                        executed: false,
+                        success: false,
+                        decision: 'ALLOWED',
+                        errorCategory: 'TIMEOUT',
+                        errorMessage: `Step execution timed out after ${timeoutMs}ms (${String(err)})`,
+                        timestamp: new Date().toISOString(),
+                    };
+                }
+                lastResult = result;
+                const durationMs = Date.now() - startTime;
+                // Observation normalization
+                const observation = {
+                    stepId: step.stepId,
+                    taskId,
+                    toolId: result.toolId,
+                    requestId: result.requestId,
+                    success: result.success,
+                    errorCategory: result.errorCategory,
+                    errorMessage: result.errorMessage,
+                    outputSummary: result.output
+                        ? {
+                            bytes: typeof result.output.bytes === 'number' ? result.output.bytes : undefined,
+                            relativePath: typeof result.output.relativePath === 'string' ? result.output.relativePath : undefined,
+                            hasContent: !!result.output.content,
+                        }
+                        : undefined,
+                    durationMs,
+                    timestamp: result.timestamp,
+                };
+                this.logger.info(`Observation recorded for step '${observation.stepId}'`, {
+                    taskId: observation.taskId,
+                    stepId: observation.stepId,
+                    toolId: observation.toolId,
+                    authorized: result.authorized,
+                    executed: result.executed,
+                    success: observation.success,
+                    durationMs: observation.durationMs,
+                });
+                // Verification Stage
+                const verification = {
+                    stepId: step.stepId,
+                    taskId,
+                    verified: result.authorized && result.executed && result.success,
+                    reason: result.success
+                        ? 'Tool execution verified successfully'
+                        : result.errorMessage || 'Execution verification failed',
+                    timestamp: new Date().toISOString(),
+                };
+                if (verification.verified) {
+                    stepSuccess = true;
+                    step.status = 'completed';
+                    completedStepCount++;
+                    // State transition: observing -> verifying
+                    task = this.taskService.transitionTask(taskId, { targetState: 'observing', currentStep: step.stepId });
+                    task = this.taskService.transitionTask(taskId, { targetState: 'verifying', currentStep: step.stepId });
+                    break; // Exit attempt loop on success
+                }
+                // Handle verification failure
+                lastErrorCategory = result.errorCategory || 'VERIFICATION_FAILED';
+                // NON-RETRYABLE SECURITY / AUTHORIZATION FAILURES: Stop immediately!
+                if (lastErrorCategory && NON_RETRYABLE_ERROR_CATEGORIES.has(lastErrorCategory)) {
+                    this.logger.warn(`Non-retryable security/structural failure encountered. Bypassing retries.`, {
+                        taskId,
+                        stepId: step.stepId,
+                        errorCategory: lastErrorCategory,
+                    });
+                    break;
+                }
+                // Retryable failure: brief pause before next attempt
+                if (attempt < maxAttempts) {
+                    await new Promise((r) => setTimeout(r, 10));
+                }
+            }
+            // If step failed after all attempts / non-retryable failure
+            if (!stepSuccess) {
+                step.status = 'failed';
+                step.errorCategory = lastErrorCategory;
+                step.errorMessage = lastResult?.errorMessage || 'Step execution failed';
+                this.logger.error(`Step failed. Failing task.`, {
+                    taskId,
+                    stepId: step.stepId,
+                    errorCategory: lastErrorCategory,
+                });
+                return this.taskService.failTask(taskId, {
+                    errorCategory: lastErrorCategory,
+                    currentStep: step.stepId,
+                });
+            }
+        }
+        // Complete task when all steps succeed and goal verification passes
+        if (options.autoComplete !== false) {
+            const workspaceRoot = this.toolGateway.getWorkspaceRoot();
+            const verifier = new GoalCompletionVerifier();
+            const verification = verifier.verifyGoal(task.title, steps, workspaceRoot);
+            if (!verification.verified) {
+                this.logger.error(`Goal verification failed for task '${taskId}'`, {
+                    errorCategory: verification.errorCategory,
+                    errorMessage: verification.errorMessage,
+                });
+                return this.taskService.failTask(taskId, {
+                    errorCategory: verification.errorCategory || 'GOAL_VERIFICATION_FAILED',
+                });
+            }
+            this.logger.info(`All execution loop steps & goal verification succeeded. Completing task.`, { taskId });
+            return this.taskService.completeTask(taskId);
+        }
+        // autoComplete=false: caller controls task state — just return current task
+        this.logger.info(`All execution loop steps completed successfully. Leaving task in current state (autoComplete=false).`, { taskId });
+        return this.taskService.getTask(taskId);
+    }
+    /**
+     * Cancel execution of a task.
+     */
+    cancelExecution(taskId) {
+        this.logger.info(`Cancelling task execution loop`, { taskId });
+        return this.taskService.cancelTask(taskId);
+    }
+    /**
+     * Helper to execute tool with a strict timeout boundary.
+     */
+    async executeWithTimeout(request, timeoutMs) {
+        if (timeoutMs <= 0) {
+            return {
+                requestId: request.requestId,
+                taskId: request.taskId,
+                toolId: request.toolId,
+                authorized: true,
+                executed: false,
+                success: false,
+                decision: 'ALLOWED',
+                errorCategory: 'TIMEOUT',
+                errorMessage: `Step execution timed out after ${timeoutMs}ms`,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Tool execution timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            try {
+                const result = this.toolGateway.executeTool(request);
+                clearTimeout(timer);
+                resolve(result);
+            }
+            catch (err) {
+                clearTimeout(timer);
+                reject(err);
+            }
+        });
+    }
+}
+//# sourceMappingURL=agentExecutionService.js.map

package/dist/orchestration/agentExecutionService.js.map

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

package/dist/orchestration/agentStateMachine.d.ts

@@ -0,0 +1,29 @@
+import type { AgentTaskState } from '../storage/repositories/types.js';
+export interface TransitionResult {
+    success: boolean;
+    previousState: AgentTaskState;
+    newState: AgentTaskState;
+    error?: string;
+}
+export declare class AgentStateMachine {
+    /**
+     * Validate and return the result of a requested forward transition.
+     * Does NOT mutate any task record directly — the caller must persist.
+     */
+    static transition(currentState: AgentTaskState, targetState: AgentTaskState): TransitionResult;
+    /**
+     * Validate a cancellation request.
+     * Cancellation is explicit and only allowed from non-terminal active states.
+     */
+    static cancel(currentState: AgentTaskState): TransitionResult;
+    /**
+     * Validate a failure transition.
+     * Failure is explicit and allowed from any active non-terminal state.
+     */
+    static fail(currentState: AgentTaskState): TransitionResult;
+    /** Returns true if the given state is terminal. */
+    static isTerminal(state: AgentTaskState): boolean;
+    /** Returns the set of valid forward successor states for a given state. */
+    static validSuccessors(state: AgentTaskState): AgentTaskState[];
+}
+//# sourceMappingURL=agentStateMachine.d.ts.map

package/dist/orchestration/agentStateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentStateMachine.d.ts","sourceRoot":"","sources":["../../src/orchestration/agentStateMachine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAmEvE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,cAAc,CAAC;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,GAAG,gBAAgB;IA2B9F;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,GAAG,gBAAgB;IA0B7D;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,gBAAgB;IA0B3D,mDAAmD;IACnD,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAIjD,2EAA2E;IAC3E,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,EAAE;CAGhE"}