@defai.digital/ax-cli 2.8.0 → 3.0.0

package/dist/planner/types.js

@@ -0,0 +1,213 @@
+/**
+ * Multi-Phase Task Planning System - Type Definitions
+ *
+ * Defines the core data structures for task decomposition,
+ * phase execution, and plan persistence.
+ */
+import { z } from "zod";
+// ============================================================================
+// Enums
+// ============================================================================
+/**
+ * Risk level for a phase - determines approval requirements
+ */
+export var RiskLevel;
+(function (RiskLevel) {
+    RiskLevel["LOW"] = "low";
+    RiskLevel["MEDIUM"] = "medium";
+    RiskLevel["HIGH"] = "high";
+})(RiskLevel || (RiskLevel = {}));
+/**
+ * Fallback strategy when a phase fails
+ */
+export var FallbackStrategy;
+(function (FallbackStrategy) {
+    FallbackStrategy["RETRY"] = "retry";
+    FallbackStrategy["SKIP"] = "skip";
+    FallbackStrategy["ABORT"] = "abort";
+})(FallbackStrategy || (FallbackStrategy = {}));
+/**
+ * Status of an individual phase
+ */
+export var PhaseStatus;
+(function (PhaseStatus) {
+    PhaseStatus["PENDING"] = "pending";
+    PhaseStatus["APPROVED"] = "approved";
+    PhaseStatus["QUEUED"] = "queued";
+    PhaseStatus["EXECUTING"] = "executing";
+    PhaseStatus["COMPLETED"] = "completed";
+    PhaseStatus["FAILED"] = "failed";
+    PhaseStatus["SKIPPED"] = "skipped";
+    PhaseStatus["CANCELLED"] = "cancelled";
+})(PhaseStatus || (PhaseStatus = {}));
+/**
+ * Status of the overall plan
+ */
+export var PlanStatus;
+(function (PlanStatus) {
+    PlanStatus["CREATED"] = "created";
+    PlanStatus["APPROVED"] = "approved";
+    PlanStatus["EXECUTING"] = "executing";
+    PlanStatus["PAUSED"] = "paused";
+    PlanStatus["COMPLETED"] = "completed";
+    PlanStatus["FAILED"] = "failed";
+    PlanStatus["ABANDONED"] = "abandoned";
+})(PlanStatus || (PlanStatus = {}));
+// ============================================================================
+// Zod Schemas for Runtime Validation
+// ============================================================================
+export const RiskLevelSchema = z.nativeEnum(RiskLevel);
+export const FallbackStrategySchema = z.nativeEnum(FallbackStrategy);
+export const PhaseStatusSchema = z.nativeEnum(PhaseStatus);
+export const PlanStatusSchema = z.nativeEnum(PlanStatus);
+export const TaskPhaseSchema = z.object({
+    id: z.string(),
+    index: z.number(),
+    name: z.string(),
+    description: z.string(),
+    objectives: z.array(z.string()),
+    toolsRequired: z.array(z.string()),
+    dependencies: z.array(z.string()),
+    canRunInParallel: z.boolean(),
+    riskLevel: RiskLevelSchema,
+    requiresApproval: z.boolean(),
+    fallbackStrategy: FallbackStrategySchema,
+    maxRetries: z.number().default(3),
+    status: PhaseStatusSchema,
+    startedAt: z.date().optional(),
+    completedAt: z.date().optional(),
+    duration: z.number().optional(),
+    checkpointId: z.string().optional(),
+    retryCount: z.number().default(0),
+    output: z.string().optional(),
+    error: z.string().optional(),
+    tokensUsed: z.number().optional(),
+    filesModified: z.array(z.string()).optional(),
+});
+export const TaskPlanSchema = z.object({
+    id: z.string(),
+    version: z.number(),
+    originalPrompt: z.string(),
+    reasoning: z.string(),
+    complexity: z.enum(["simple", "moderate", "complex"]),
+    phases: z.array(TaskPhaseSchema),
+    currentPhaseIndex: z.number(),
+    status: PlanStatusSchema,
+    createdAt: z.date(),
+    updatedAt: z.date(),
+    estimatedTotalTokens: z.number(),
+    estimatedDuration: z.number(),
+    initialCheckpointId: z.string().optional(),
+    totalTokensUsed: z.number().default(0),
+    actualDuration: z.number().default(0),
+    phasesCompleted: z.number().default(0),
+    phasesFailed: z.number().default(0),
+    phasesSkipped: z.number().default(0),
+});
+export const PhaseResultSchema = z.object({
+    phaseId: z.string(),
+    success: z.boolean(),
+    output: z.string().optional(),
+    error: z.string().optional(),
+    duration: z.number(),
+    tokensUsed: z.number(),
+    filesModified: z.array(z.string()),
+    checkpointId: z.string().optional(),
+    wasRetry: z.boolean(),
+    retryAttempt: z.number(),
+});
+// ============================================================================
+// LLM Response Schemas (for parsing plan generation)
+// ============================================================================
+/**
+ * Schema for LLM-generated phase (before adding execution state)
+ */
+export const LLMPhaseResponseSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    objectives: z.array(z.string()),
+    toolsRequired: z.array(z.string()).default([]),
+    dependencies: z.array(z.string()).default([]),
+    canRunInParallel: z.boolean().default(false),
+    riskLevel: z.enum(["low", "medium", "high"]).default("low"),
+    requiresApproval: z.boolean().default(false),
+});
+/**
+ * Schema for LLM-generated plan response
+ */
+export const LLMPlanResponseSchema = z.object({
+    reasoning: z.string(),
+    complexity: z.enum(["simple", "moderate", "complex"]),
+    phases: z.array(LLMPhaseResponseSchema),
+});
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create a new TaskPhase with defaults
+ */
+export function createPhase(partial) {
+    return {
+        objectives: [],
+        toolsRequired: [],
+        dependencies: [],
+        canRunInParallel: false,
+        riskLevel: RiskLevel.LOW,
+        requiresApproval: false,
+        fallbackStrategy: FallbackStrategy.ABORT,
+        maxRetries: 3,
+        status: PhaseStatus.PENDING,
+        retryCount: 0,
+        ...partial,
+    };
+}
+/**
+ * Create a new TaskPlan with defaults
+ */
+export function createPlan(partial) {
+    const now = new Date();
+    return {
+        version: 1,
+        reasoning: "",
+        complexity: "moderate",
+        currentPhaseIndex: -1,
+        status: PlanStatus.CREATED,
+        createdAt: now,
+        updatedAt: now,
+        estimatedTotalTokens: 0,
+        estimatedDuration: 0,
+        totalTokensUsed: 0,
+        actualDuration: 0,
+        phasesCompleted: 0,
+        phasesFailed: 0,
+        phasesSkipped: 0,
+        ...partial,
+    };
+}
+/**
+ * Create default execution options
+ */
+export function createDefaultExecutionOptions() {
+    return {
+        autoApprove: false,
+        autoApproveLowRisk: false,
+        createCheckpoints: true,
+        pruneContextBetweenPhases: true,
+        targetContextPercentage: 50,
+        maxParallelPhases: 5,
+        phaseTimeoutMs: 600000, // 10 minutes
+    };
+}
+/**
+ * Create default planner options
+ */
+export function createDefaultPlannerOptions() {
+    return {
+        maxPhases: 10,
+        autoPlanThreshold: 3,
+        requirePlanApproval: true,
+        requireHighRiskApproval: true,
+        defaultExecutionOptions: createDefaultExecutionOptions(),
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/planner/types.js.map

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

package/dist/schemas/confirmation-schemas.d.ts

@@ -58,3 +58,8 @@ export declare function safeValidateConfirmationOptions(data: unknown): {
     error?: z.ZodError;
 };
 export declare function validateConfirmationResult(data: unknown): ConfirmationResult;
+export declare function safeValidateConfirmationResult(data: unknown): {
+    success: boolean;
+    data?: ConfirmationResult;
+    error?: z.ZodError;
+};

package/dist/schemas/confirmation-schemas.js

@@ -38,4 +38,11 @@ export function safeValidateConfirmationOptions(data) {
 export function validateConfirmationResult(data) {
     return ConfirmationResultSchema.parse(data);
 }
+export function safeValidateConfirmationResult(data) {
+    const result = ConfirmationResultSchema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return { success: false, error: result.error };
+}
 //# sourceMappingURL=confirmation-schemas.js.map

package/dist/schemas/confirmation-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"confirmation-schemas.js","sourceRoot":"","sources":["../../src/schemas/confirmation-schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8BAA8B;AAC9B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAChD,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAIH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAIH,uBAAuB;AACvB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;CAC3B,CAAC,CAAC;AAIH;;GAEG;AAEH,MAAM,UAAU,2BAA2B,CACzC,IAAa;IAEb,OAAO,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAK3D,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAa;IACtD,OAAO,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"confirmation-schemas.js","sourceRoot":"","sources":["../../src/schemas/confirmation-schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8BAA8B;AAC9B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;IAChD,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAIH,6BAA6B;AAC7B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAIH,uBAAuB;AACvB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;CAC3B,CAAC,CAAC;AAIH;;GAEG;AAEH,MAAM,UAAU,2BAA2B,CACzC,IAAa;IAEb,OAAO,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAK3D,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAa;IACtD,OAAO,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,IAAa;IAK1D,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AACjD,CAAC"}

package/dist/schemas/index.d.ts

@@ -94,16 +94,16 @@ export declare const ProjectTemplateSchema: z.ZodObject<{
     description: string;
     id: string;
     version: string;
+    createdAt: string;
+    projectType: string;
     metadata: {
         scripts?: Record<string, string> | undefined;
         directories?: Record<string, string> | undefined;
         conventions?: Record<string, string> | undefined;
         keyFiles?: string[] | undefined;
     };
-    projectType: string;
     tags: string[];
     instructions: string;
-    createdAt: string;
     isBuiltIn: boolean;
     author?: string | undefined;
 }, {
@@ -111,16 +111,16 @@ export declare const ProjectTemplateSchema: z.ZodObject<{
     description: string;
     id: string;
     version: string;
+    createdAt: string;
+    projectType: string;
     metadata: {
         scripts?: Record<string, string> | undefined;
         directories?: Record<string, string> | undefined;
         conventions?: Record<string, string> | undefined;
         keyFiles?: string[] | undefined;
     };
-    projectType: string;
     tags: string[];
     instructions: string;
-    createdAt: string;
     isBuiltIn: boolean;
     author?: string | undefined;
 }>;

package/dist/tools/bash-output.d.ts

@@ -0,0 +1,25 @@
+import { ToolResult } from '../types/index.js';
+/**
+ * BashOutputTool - Retrieve output from background tasks
+ *
+ * This tool allows the AI agent to check on and retrieve output
+ * from commands that were run in the background.
+ */
+export declare class BashOutputTool {
+    private backgroundTaskManager;
+    /**
+     * Get output from a background task
+     * @param taskId The background task ID
+     * @param wait Whether to wait for the task to complete (default: false)
+     * @param timeoutMs Maximum time to wait in milliseconds (default: 30000)
+     */
+    execute(taskId: string, wait?: boolean, timeoutMs?: number): Promise<ToolResult>;
+    /**
+     * List all background tasks
+     */
+    listTasks(): ToolResult;
+    /**
+     * Kill a background task
+     */
+    killTask(taskId: string): ToolResult;
+}

package/dist/tools/bash-output.js

@@ -0,0 +1,145 @@
+import { getBackgroundTaskManager } from '../utils/background-task-manager.js';
+/**
+ * BashOutputTool - Retrieve output from background tasks
+ *
+ * This tool allows the AI agent to check on and retrieve output
+ * from commands that were run in the background.
+ */
+export class BashOutputTool {
+    backgroundTaskManager = getBackgroundTaskManager();
+    /**
+     * Get output from a background task
+     * @param taskId The background task ID
+     * @param wait Whether to wait for the task to complete (default: false)
+     * @param timeoutMs Maximum time to wait in milliseconds (default: 30000)
+     */
+    async execute(taskId, wait = false, timeoutMs = 30000) {
+        if (!taskId) {
+            return {
+                success: false,
+                error: 'Task ID is required'
+            };
+        }
+        try {
+            let output;
+            if (wait) {
+                // Wait for task to complete
+                output = await this.backgroundTaskManager.waitForTask(taskId, timeoutMs);
+            }
+            else {
+                output = this.backgroundTaskManager.getOutput(taskId);
+            }
+            if (!output) {
+                return {
+                    success: false,
+                    error: `Task not found: ${taskId}`
+                };
+            }
+            // Format output
+            const statusEmoji = {
+                'running': '🔄',
+                'completed': '✅',
+                'failed': '❌',
+                'killed': '🛑'
+            }[output.status] || '❓';
+            let result = `${statusEmoji} Task ${taskId}\n`;
+            result += `Status: ${output.status}`;
+            if (output.exitCode !== undefined && output.exitCode !== null) {
+                result += ` (exit code: ${output.exitCode})`;
+            }
+            result += '\n';
+            if (output.startTime) {
+                const elapsed = output.endTime
+                    ? Math.round((output.endTime.getTime() - output.startTime.getTime()) / 1000)
+                    : Math.round((Date.now() - output.startTime.getTime()) / 1000);
+                result += `Duration: ${elapsed}s\n`;
+            }
+            result += '\n';
+            if (output.stdout) {
+                result += '--- STDOUT ---\n';
+                result += output.stdout;
+                result += '\n';
+            }
+            if (output.stderr) {
+                result += '--- STDERR ---\n';
+                result += output.stderr;
+                result += '\n';
+            }
+            if (!output.stdout && !output.stderr) {
+                result += '(No output yet)\n';
+            }
+            return {
+                success: true,
+                output: result.trim()
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to get task output: ${error.message}`
+            };
+        }
+    }
+    /**
+     * List all background tasks
+     */
+    listTasks() {
+        const tasks = this.backgroundTaskManager.listTasks();
+        if (tasks.length === 0) {
+            return {
+                success: true,
+                output: 'No background tasks'
+            };
+        }
+        let result = `📋 Background Tasks (${tasks.length})\n\n`;
+        const statusEmoji = {
+            'running': '🔄',
+            'completed': '✅',
+            'failed': '❌',
+            'killed': '🛑'
+        };
+        for (const task of tasks) {
+            const emoji = statusEmoji[task.status] || '❓';
+            const elapsed = task.endTime
+                ? Math.round((task.endTime.getTime() - task.startTime.getTime()) / 1000)
+                : Math.round((Date.now() - task.startTime.getTime()) / 1000);
+            result += `${emoji} ${task.id}\n`;
+            result += `   Command: ${task.command.length > 50 ? task.command.slice(0, 50) + '...' : task.command}\n`;
+            result += `   Status: ${task.status}`;
+            if (task.exitCode !== undefined && task.exitCode !== null) {
+                result += ` (exit: ${task.exitCode})`;
+            }
+            result += ` | Duration: ${elapsed}s\n`;
+            result += '\n';
+        }
+        return {
+            success: true,
+            output: result.trim()
+        };
+    }
+    /**
+     * Kill a background task
+     */
+    killTask(taskId) {
+        if (!taskId) {
+            return {
+                success: false,
+                error: 'Task ID is required'
+            };
+        }
+        const killed = this.backgroundTaskManager.kill(taskId);
+        if (killed) {
+            return {
+                success: true,
+                output: `🛑 Task ${taskId} has been killed`
+            };
+        }
+        else {
+            return {
+                success: false,
+                error: `Could not kill task ${taskId}. It may not exist or is not running.`
+            };
+        }
+    }
+}
+//# sourceMappingURL=bash-output.js.map

package/dist/tools/bash-output.js.map

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

package/dist/tools/bash.d.ts

@@ -1,10 +1,54 @@
 import { ToolResult } from '../types/index.js';
-export declare class BashTool {
+import { EventEmitter } from 'events';
+export interface BashExecuteOptions {
+    timeout?: number;
+    background?: boolean;
+    /** Abort signal to cancel execution or move to background */
+    signal?: AbortSignal;
+}
+/**
+ * Result when command is moved to background
+ */
+export interface BackgroundTransferResult {
+    movedToBackground: true;
+    taskId: string;
+    partialOutput: string;
+}
+export declare class BashTool extends EventEmitter {
     private static readonly MAX_BUFFER_SIZE;
     private static readonly DEFAULT_TIMEOUT;
     private currentDirectory;
     private confirmationService;
-    execute(command: string, timeout?: number): Promise<ToolResult>;
+    private backgroundTaskManager;
+    /** Currently running process (for Ctrl+B transfer) */
+    private currentProcess;
+    private currentCommand;
+    private currentOutput;
+    constructor();
+    /**
+     * Check if a command is currently executing
+     */
+    isExecuting(): boolean;
+    /**
+     * Move the currently running command to background
+     * Returns task ID if successful, null if no command is running
+     */
+    moveToBackground(): string | null;
+    /**
+     * Execute a bash command
+     * @param command The command to execute
+     * @param options Execution options (timeout, background, signal)
+     */
+    execute(command: string, options?: BashExecuteOptions | number): Promise<ToolResult>;
+    /**
+     * Handle cd command separately (no spawn needed)
+     */
+    private handleCdCommand;
+    /**
+     * Execute command using spawn (interruptible)
+     * Returns ToolResult normally, or BackgroundTransferResult if moved to background
+     */
+    private executeWithSpawn;
     getCurrentDirectory(): string;
     listFiles(directory?: string): Promise<ToolResult>;
     findFiles(pattern: string, directory?: string): Promise<ToolResult>;