@nexus-ai-nexoralabs/cli 0.1.0

package/dist/orchestration/agentStateMachine.js

@@ -0,0 +1,153 @@
+/**
+ * NEXUS AI — Agent State Machine
+ *
+ * Defines and enforces the deterministic lifecycle of an agent task.
+ * ALL state transitions MUST go through this class.
+ * No external code may directly mutate AgentTask.state.
+ *
+ * Lifecycle:
+ *   created → planning → awaiting_approval → executing → observing → verifying → completed
+ *
+ * Failure path (from any active state):
+ *   * → failed
+ *
+ * Cancellation path (from any non-terminal active state):
+ *   * → cancelled
+ *
+ * Terminal states (no further transitions):
+ *   completed | failed | cancelled
+ */
+/** All states from which a task may be cancelled. */
+const CANCELLABLE_STATES = new Set([
+    'created',
+    'planning',
+    'awaiting_approval',
+    'executing',
+    'observing',
+    'verifying',
+]);
+/** All states from which a task may fail. */
+const FAILABLE_STATES = new Set([
+    'created',
+    'planning',
+    'awaiting_approval',
+    'executing',
+    'observing',
+    'verifying',
+]);
+/** States that accept no further transitions. */
+const TERMINAL_STATES = new Set([
+    'completed',
+    'failed',
+    'cancelled',
+]);
+/**
+ * Explicit forward transition map.
+ * A transition is ONLY valid if it is listed here.
+ * Cancellation and failure are handled via their dedicated methods.
+ */
+const VALID_FORWARD_TRANSITIONS = new Map([
+    ['created', new Set(['planning'])],
+    ['planning', new Set(['awaiting_approval', 'executing'])],
+    ['awaiting_approval', new Set(['executing', 'cancelled'])],
+    ['executing', new Set(['observing'])],
+    ['observing', new Set(['verifying', 'executing'])],
+    ['verifying', new Set(['completed', 'executing', 'planning'])],
+    // Terminal states have no forward successors
+    ['completed', new Set()],
+    ['failed', new Set()],
+    ['cancelled', new Set()],
+]);
+export 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, targetState) {
+        if (TERMINAL_STATES.has(currentState)) {
+            return {
+                success: false,
+                previousState: currentState,
+                newState: currentState,
+                error: `Transition rejected: task is in terminal state '${currentState}' and cannot transition to '${targetState}'.`,
+            };
+        }
+        const allowed = VALID_FORWARD_TRANSITIONS.get(currentState);
+        if (!allowed || !allowed.has(targetState)) {
+            return {
+                success: false,
+                previousState: currentState,
+                newState: currentState,
+                error: `Transition rejected: '${currentState}' → '${targetState}' is not a valid transition.`,
+            };
+        }
+        return {
+            success: true,
+            previousState: currentState,
+            newState: targetState,
+        };
+    }
+    /**
+     * Validate a cancellation request.
+     * Cancellation is explicit and only allowed from non-terminal active states.
+     */
+    static cancel(currentState) {
+        if (TERMINAL_STATES.has(currentState)) {
+            return {
+                success: false,
+                previousState: currentState,
+                newState: currentState,
+                error: `Cancellation rejected: task is already in terminal state '${currentState}'.`,
+            };
+        }
+        if (!CANCELLABLE_STATES.has(currentState)) {
+            return {
+                success: false,
+                previousState: currentState,
+                newState: currentState,
+                error: `Cancellation rejected: state '${currentState}' is not cancellable.`,
+            };
+        }
+        return {
+            success: true,
+            previousState: currentState,
+            newState: 'cancelled',
+        };
+    }
+    /**
+     * Validate a failure transition.
+     * Failure is explicit and allowed from any active non-terminal state.
+     */
+    static fail(currentState) {
+        if (TERMINAL_STATES.has(currentState)) {
+            return {
+                success: false,
+                previousState: currentState,
+                newState: currentState,
+                error: `Failure rejected: task is already in terminal state '${currentState}'.`,
+            };
+        }
+        if (!FAILABLE_STATES.has(currentState)) {
+            return {
+                success: false,
+                previousState: currentState,
+                newState: currentState,
+                error: `Failure rejected: state '${currentState}' cannot transition to 'failed'.`,
+            };
+        }
+        return {
+            success: true,
+            previousState: currentState,
+            newState: 'failed',
+        };
+    }
+    /** Returns true if the given state is terminal. */
+    static isTerminal(state) {
+        return TERMINAL_STATES.has(state);
+    }
+    /** Returns the set of valid forward successor states for a given state. */
+    static validSuccessors(state) {
+        return Array.from(VALID_FORWARD_TRANSITIONS.get(state) ?? []);
+    }
+}
+//# sourceMappingURL=agentStateMachine.js.map

package/dist/orchestration/agentStateMachine.js.map

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

package/dist/orchestration/agentTaskService.d.ts

@@ -0,0 +1,44 @@
+import type { AgentTaskRepository } from '../storage/repositories/agentTaskRepository.js';
+import type { AgentTask, AgentTaskState } from '../storage/repositories/types.js';
+import { LogLevel } from '../common/logger.js';
+export interface CreateAgentTaskDto {
+    id?: string;
+    projectId?: string | null;
+    title: string;
+}
+export interface TransitionAgentTaskDto {
+    targetState: AgentTaskState;
+    currentStep?: string | null;
+    plan?: string | null;
+}
+export interface FailAgentTaskDto {
+    errorCategory: string;
+    currentStep?: string | null;
+}
+/**
+ * NEXUS AI — Agent Task Service
+ *
+ * Owns the lifecycle of agent tasks. All business logic
+ * (state transitions, validation, error handling) lives here.
+ * The repository layer is limited to persistence only.
+ *
+ * NOTE: This service manages task state only.
+ * State = executing does NOT grant permission to run tools.
+ * Tool authorization is handled in a separate P5-B sub-phase.
+ */
+export declare class AgentTaskService {
+    private taskRepo;
+    private logger;
+    constructor(taskRepo: AgentTaskRepository, logLevel?: LogLevel);
+    createTask(dto: CreateAgentTaskDto): AgentTask;
+    getTask(id: string): AgentTask;
+    listTasks(projectId?: string | null): AgentTask[];
+    getTasksByState(state: AgentTaskState): AgentTask[];
+    transitionTask(id: string, dto: TransitionAgentTaskDto): AgentTask;
+    setTaskPlan(id: string, plan: string): AgentTask;
+    cancelTask(id: string): AgentTask;
+    failTask(id: string, dto: FailAgentTaskDto): AgentTask;
+    completeTask(id: string): AgentTask;
+    deleteTask(id: string): boolean;
+}
+//# sourceMappingURL=agentTaskService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentTaskService.d.ts","sourceRoot":"","sources":["../../src/orchestration/agentTaskService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAC1F,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElF,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,cAAc,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ;IAHlB,OAAO,CAAC,MAAM,CAAS;gBAGb,QAAQ,EAAE,mBAAmB,EACrC,QAAQ,GAAE,QAAiB;IAS7B,UAAU,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS;IAgB9C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS;IAQ9B,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE;IAOjD,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,EAAE;IAQnD,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,SAAS;IAkClE,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS;IAmBhD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS;IAgCjC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS;IAgCtD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS;IAQnC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAKhC"}

package/dist/orchestration/agentTaskService.js

@@ -0,0 +1,168 @@
+import { AgentStateMachine } from './agentStateMachine.js';
+import { Logger } from '../common/logger.js';
+/**
+ * NEXUS AI — Agent Task Service
+ *
+ * Owns the lifecycle of agent tasks. All business logic
+ * (state transitions, validation, error handling) lives here.
+ * The repository layer is limited to persistence only.
+ *
+ * NOTE: This service manages task state only.
+ * State = executing does NOT grant permission to run tools.
+ * Tool authorization is handled in a separate P5-B sub-phase.
+ */
+export class AgentTaskService {
+    taskRepo;
+    logger;
+    constructor(taskRepo, logLevel = 'info') {
+        this.taskRepo = taskRepo;
+        this.logger = new Logger('AgentTaskService', logLevel);
+    }
+    // ---------------------------------------------------------------------------
+    // Creation
+    // ---------------------------------------------------------------------------
+    createTask(dto) {
+        const id = dto.id ?? `task-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`;
+        this.logger.info(`Creating agent task`, { taskId: id, title: dto.title });
+        return this.taskRepo.create({
+            id,
+            projectId: dto.projectId ?? null,
+            title: dto.title,
+            plan: null,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Retrieval
+    // ---------------------------------------------------------------------------
+    getTask(id) {
+        const task = this.taskRepo.findById(id);
+        if (!task) {
+            throw new Error(`AgentTask not found: '${id}'`);
+        }
+        return task;
+    }
+    listTasks(projectId) {
+        if (projectId === undefined) {
+            return this.taskRepo.listAll();
+        }
+        return this.taskRepo.listByProject(projectId);
+    }
+    getTasksByState(state) {
+        return this.taskRepo.findByState(state);
+    }
+    // ---------------------------------------------------------------------------
+    // State transitions (forward)
+    // ---------------------------------------------------------------------------
+    transitionTask(id, dto) {
+        const task = this.getTask(id);
+        const result = AgentStateMachine.transition(task.state, dto.targetState);
+        if (!result.success) {
+            this.logger.warn(`State transition rejected`, {
+                taskId: id,
+                from: result.previousState,
+                to: dto.targetState,
+                reason: result.error,
+            });
+            throw new Error(result.error);
+        }
+        this.logger.info(`Agent task state transition`, {
+            taskId: id,
+            from: result.previousState,
+            to: result.newState,
+        });
+        this.taskRepo.updateState(id, {
+            state: result.newState,
+            currentStep: dto.currentStep ?? null,
+            stepStatus: result.newState === 'completed' ? 'done' : 'active',
+            attemptCount: task.attemptCount,
+            errorCategory: null,
+            cancelledAt: null,
+            completedAt: result.newState === 'completed' ? new Date().toISOString() : null,
+            plan: dto.plan ?? undefined,
+        });
+        return this.getTask(id);
+    }
+    setTaskPlan(id, plan) {
+        const task = this.getTask(id);
+        this.taskRepo.updateState(id, {
+            state: task.state,
+            currentStep: task.currentStep,
+            stepStatus: task.stepStatus,
+            attemptCount: task.attemptCount,
+            errorCategory: task.errorCategory,
+            cancelledAt: task.cancelledAt,
+            completedAt: task.completedAt,
+            plan,
+        });
+        return this.getTask(id);
+    }
+    // ---------------------------------------------------------------------------
+    // Terminal transitions
+    // ---------------------------------------------------------------------------
+    cancelTask(id) {
+        const task = this.getTask(id);
+        const result = AgentStateMachine.cancel(task.state);
+        if (!result.success) {
+            this.logger.warn(`Task cancellation rejected`, {
+                taskId: id,
+                currentState: task.state,
+                reason: result.error,
+            });
+            throw new Error(result.error);
+        }
+        this.logger.info(`Agent task cancelled`, {
+            taskId: id,
+            previousState: result.previousState,
+        });
+        const now = new Date().toISOString();
+        this.taskRepo.updateState(id, {
+            state: 'cancelled',
+            currentStep: task.currentStep,
+            stepStatus: 'error',
+            attemptCount: task.attemptCount,
+            errorCategory: null,
+            cancelledAt: now,
+            completedAt: null,
+        });
+        return this.getTask(id);
+    }
+    failTask(id, dto) {
+        const task = this.getTask(id);
+        const result = AgentStateMachine.fail(task.state);
+        if (!result.success) {
+            this.logger.warn(`Task failure transition rejected`, {
+                taskId: id,
+                currentState: task.state,
+                reason: result.error,
+            });
+            throw new Error(result.error);
+        }
+        this.logger.error(`Agent task failed`, {
+            taskId: id,
+            previousState: result.previousState,
+            errorCategory: dto.errorCategory,
+        });
+        this.taskRepo.updateState(id, {
+            state: 'failed',
+            currentStep: dto.currentStep ?? task.currentStep,
+            stepStatus: 'error',
+            attemptCount: task.attemptCount,
+            errorCategory: dto.errorCategory,
+            cancelledAt: null,
+            completedAt: null,
+        });
+        return this.getTask(id);
+    }
+    completeTask(id) {
+        return this.transitionTask(id, { targetState: 'completed' });
+    }
+    // ---------------------------------------------------------------------------
+    // Deletion
+    // ---------------------------------------------------------------------------
+    deleteTask(id) {
+        const task = this.getTask(id);
+        this.logger.info(`Deleting agent task`, { taskId: id, state: task.state });
+        return this.taskRepo.deleteById(id);
+    }
+}
+//# sourceMappingURL=agentTaskService.js.map

package/dist/orchestration/agentTaskService.js.map

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

package/dist/orchestration/codingAgentDiscovery.d.ts

@@ -0,0 +1,32 @@
+/**
+ * NEXUS AI — P6-D: Coding Agent Codebase Discovery
+ *
+ * Gathers bounded, secret-safe codebase evidence using registered discovery tools:
+ *  - workspace_tree
+ *  - code_search
+ *  - filesystem_read
+ *
+ * SECURITY INVARIANTS:
+ *  - Workspace sandboxed — paths outside workspace are rejected.
+ *  - Secret-safe — secret files (.env, *.key, *.pem, id_rsa, credentials.json) are excluded.
+ *  - Bounded — snippet lengths and file counts are capped to prevent context overflow.
+ *  - Read-only — zero filesystem modifications.
+ */
+import type { ToolGateway } from '../tools/index.js';
+import type { CodebaseEvidence } from './codingAgentTypes.js';
+import { LogLevel } from '../common/logger.js';
+export declare class CodingAgentDiscovery {
+    private toolGateway;
+    private logger;
+    constructor(toolGateway: ToolGateway, logLevel?: LogLevel);
+    /**
+     * Discover evidence for a user task goal within the configured workspace.
+     *
+     * @param taskId Unique task ID.
+     * @param goal User task goal string.
+     * @param searchKeywords Keywords extracted or inferred for code search.
+     * @returns Bounded, secret-safe CodebaseEvidence object.
+     */
+    discoverCodebase(taskId: string, goal: string, searchKeywords?: string[]): Promise<CodebaseEvidence>;
+}
+//# sourceMappingURL=codingAgentDiscovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codingAgentDiscovery.d.ts","sourceRoot":"","sources":["../../src/orchestration/codingAgentDiscovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAA8C,MAAM,uBAAuB,CAAC;AAC1G,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,WAAW;IAHrB,OAAO,CAAC,MAAM,CAAS;gBAGb,WAAW,EAAE,WAAW,EAChC,QAAQ,GAAE,QAAiB;IAK7B;;;;;;;OAOG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,cAAc,GAAE,MAAM,EAAO,GAC5B,OAAO,CAAC,gBAAgB,CAAC;CAyI7B"}

package/dist/orchestration/codingAgentDiscovery.js

@@ -0,0 +1,148 @@
+/**
+ * NEXUS AI — P6-D: Coding Agent Codebase Discovery
+ *
+ * Gathers bounded, secret-safe codebase evidence using registered discovery tools:
+ *  - workspace_tree
+ *  - code_search
+ *  - filesystem_read
+ *
+ * SECURITY INVARIANTS:
+ *  - Workspace sandboxed — paths outside workspace are rejected.
+ *  - Secret-safe — secret files (.env, *.key, *.pem, id_rsa, credentials.json) are excluded.
+ *  - Bounded — snippet lengths and file counts are capped to prevent context overflow.
+ *  - Read-only — zero filesystem modifications.
+ */
+import { isSecretFile } from '../tools/index.js';
+import { Logger } from '../common/logger.js';
+export class CodingAgentDiscovery {
+    toolGateway;
+    logger;
+    constructor(toolGateway, logLevel = 'info') {
+        this.toolGateway = toolGateway;
+        this.logger = new Logger('CodingAgentDiscovery', logLevel);
+    }
+    /**
+     * Discover evidence for a user task goal within the configured workspace.
+     *
+     * @param taskId Unique task ID.
+     * @param goal User task goal string.
+     * @param searchKeywords Keywords extracted or inferred for code search.
+     * @returns Bounded, secret-safe CodebaseEvidence object.
+     */
+    async discoverCodebase(taskId, goal, searchKeywords = []) {
+        this.logger.info(`Starting codebase discovery for task`, { taskId, goal });
+        const secretFilesExcluded = [];
+        const discoveredFiles = [];
+        const searchResults = [];
+        let treeEntriesCount = 0;
+        let packageInfo = undefined;
+        // 1. Explore workspace directory tree (bounded)
+        const treeReqId = `req-tree-${taskId}`;
+        const treeResult = this.toolGateway.executeTool({
+            requestId: treeReqId,
+            taskId,
+            toolId: 'workspace_tree',
+            requestedCapabilities: ['filesystem.read'],
+            params: { path: '.', maxDepth: 4, maxEntries: 200 },
+        });
+        const resolvedTreeResult = treeResult instanceof Promise ? await treeResult : treeResult;
+        if (resolvedTreeResult.success && resolvedTreeResult.output?.entries) {
+            const rawEntries = resolvedTreeResult.output.entries;
+            treeEntriesCount = rawEntries.length;
+            for (const entry of rawEntries) {
+                if (isSecretFile(entry.path)) {
+                    secretFilesExcluded.push(entry.path);
+                    continue;
+                }
+                if (entry.type === 'file') {
+                    discoveredFiles.push({
+                        relativePath: entry.path,
+                        size: entry.size,
+                        isSecret: false,
+                    });
+                }
+            }
+        }
+        // 2. Read package.json if present for project context
+        const hasPackageJson = discoveredFiles.some((f) => f.relativePath === 'package.json');
+        if (hasPackageJson) {
+            const readPkgResult = this.toolGateway.executeTool({
+                requestId: `req-pkg-${taskId}`,
+                taskId,
+                toolId: 'filesystem_read',
+                requestedCapabilities: ['filesystem.read'],
+                params: { relativePath: 'package.json' },
+            });
+            const resolvedPkg = readPkgResult instanceof Promise ? await readPkgResult : readPkgResult;
+            if (resolvedPkg.success && typeof resolvedPkg.output?.content === 'string') {
+                try {
+                    const parsed = JSON.parse(resolvedPkg.output.content);
+                    packageInfo = {
+                        name: parsed.name,
+                        version: parsed.version,
+                        scripts: parsed.scripts,
+                    };
+                }
+                catch {
+                    /* ignore parse error */
+                }
+            }
+        }
+        // 3. Search code for relevant terms in task goal & keywords
+        const keywordsToSearch = new Set();
+        for (const kw of searchKeywords) {
+            if (kw && kw.trim().length >= 3) {
+                keywordsToSearch.add(kw.trim());
+            }
+        }
+        // Extract identifiers from task goal
+        const goalTokens = goal.match(/\b[a-zA-Z_][a-zA-Z0-9_\-\.]*\b/g) || [];
+        for (const token of goalTokens) {
+            if (token.length >= 4 && !['task', 'fix', 'code', 'file', 'test', 'run', 'make', 'with', 'from', 'that', 'this'].includes(token.toLowerCase())) {
+                keywordsToSearch.add(token);
+            }
+        }
+        for (const kw of Array.from(keywordsToSearch).slice(0, 3)) {
+            const searchRes = this.toolGateway.executeTool({
+                requestId: `req-search-${taskId}-${kw}`,
+                taskId,
+                toolId: 'code_search',
+                requestedCapabilities: ['filesystem.read'],
+                params: { query: kw, path: '.', maxResults: 10 },
+            });
+            const resolvedSearch = searchRes instanceof Promise ? await searchRes : searchRes;
+            if (resolvedSearch.success && Array.isArray(resolvedSearch.output?.results)) {
+                const matches = resolvedSearch.output.results;
+                for (const m of matches) {
+                    if (isSecretFile(m.path)) {
+                        if (!secretFilesExcluded.includes(m.path)) {
+                            secretFilesExcluded.push(m.path);
+                        }
+                        continue;
+                    }
+                    searchResults.push({
+                        relativePath: m.path,
+                        line: m.line,
+                        match: m.match,
+                        snippet: m.snippet.slice(0, 200), // bounded snippet length
+                    });
+                }
+            }
+        }
+        this.logger.info(`Codebase discovery completed`, {
+            taskId,
+            filesDiscoveredCount: discoveredFiles.length,
+            searchResultsCount: searchResults.length,
+            secretsExcludedCount: secretFilesExcluded.length,
+        });
+        return {
+            workspaceRoot: '.',
+            discoveredFiles: discoveredFiles.slice(0, 50), // bounded file count
+            searchResults: searchResults.slice(0, 20), // bounded search results
+            treeEntriesCount,
+            packageInfo,
+            secretFilesExcluded,
+        };
+    }
+}
+//# sourceMappingURL=codingAgentDiscovery.js.map

package/dist/orchestration/codingAgentDiscovery.js.map

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

package/dist/orchestration/codingAgentService.d.ts

@@ -0,0 +1,40 @@
+/**
+ * NEXUS AI — P6-D: Coding Agent Service
+ *
+ * Orchestrates the full coding-agent lifecycle:
+ *   Discovery -> Plan Synthesis -> Plan Validation -> Permission & Approval Evaluation
+ *   -> Execution -> Validation Commands -> Verification -> Bounded Repair Loop -> Completion.
+ *
+ * SECURITY INVARIANTS:
+ *  - Orchestrator ONLY. Does NOT bypass PlanValidator, PermissionEngine, ApprovalGate, or ToolExecutor.
+ *  - Non-repairable security errors (PERMISSION_DENIED, PATH_TRAVERSAL_DENIED, etc.) stop repair loops immediately.
+ *  - Strict repair attempt budget (default 3 retries max) prevents infinite loops.
+ *  - APPROVAL != PERMISSION: Human approval never grants permission if policy denies it.
+ */
+import type { AgentTaskService } from './agentTaskService.js';
+import type { AgentExecutionService } from './agentExecutionService.js';
+import type { PlanSynthesisService } from './planner.js';
+import type { PlanValidator } from './planner.js';
+import type { ToolGateway } from '../tools/index.js';
+import type { CodingAgentTaskOptions, CodingAgentRunResult } from './codingAgentTypes.js';
+import { LogLevel } from '../common/logger.js';
+export declare class CodingAgentService {
+    private taskService;
+    private toolGateway;
+    private executionService?;
+    private planner?;
+    private planValidator?;
+    private discovery;
+    private verifier;
+    private repairService?;
+    private logger;
+    constructor(taskService: AgentTaskService, toolGateway: ToolGateway, executionService?: AgentExecutionService | undefined, planner?: PlanSynthesisService | undefined, planValidator?: PlanValidator | undefined, logLevel?: LogLevel);
+    /**
+     * Run a full coding task with bounded discovery, planning, execution, validation, and repair loop.
+     *
+     * @param options Coding agent task configuration options.
+     * @returns Deterministic CodingAgentRunResult.
+     */
+    runCodingTask(options: CodingAgentTaskOptions): Promise<CodingAgentRunResult>;
+}
+//# sourceMappingURL=codingAgentService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codingAgentService.d.ts","sourceRoot":"","sources":["../../src/orchestration/codingAgentService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EAIrB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD,qBAAa,kBAAkB;IAO3B,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,gBAAgB,CAAC;IACzB,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,aAAa,CAAC;IAVxB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAsB;IAC5C,OAAO,CAAC,MAAM,CAAS;gBAGb,WAAW,EAAE,gBAAgB,EAC7B,WAAW,EAAE,WAAW,EACxB,gBAAgB,CAAC,EAAE,qBAAqB,YAAA,EACxC,OAAO,CAAC,EAAE,oBAAoB,YAAA,EAC9B,aAAa,CAAC,EAAE,aAAa,YAAA,EACrC,QAAQ,GAAE,QAAiB;IAW7B;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA2SpF"}