vigthoria-cli 1.10.51 → 1.11.0

package/dist/utils/agentRunOutcome.js

@@ -0,0 +1,123 @@
+/**
+ * Task-and-quality-validated success evaluation for V3 agent runs.
+ * Decouples CLI verdict from raw file-change counts (1.11.0+).
+ */
+export function createLiveOutcome() {
+    return {
+        executorFailed: false,
+        plannerError: null,
+        executorError: null,
+        tasksTotal: 0,
+        tasksSucceeded: 0,
+        changedFileCount: 0,
+        requiresWorkspaceChanges: false,
+        workspaceHasOutput: false,
+        failedTaskIds: new Set(),
+        analysisToolsUsed: 0,
+    };
+}
+/** Process executor_complete / task summary events from the V3 SSE stream. */
+export function handleTaskEvent(summary, liveOutcome) {
+    const tid = summary.task_id || summary.id;
+    const status = String(summary.status || '').toLowerCase();
+    if (status === 'completed' || status === 'success') {
+        if (tid) {
+            liveOutcome.failedTaskIds.delete(String(tid));
+        }
+        liveOutcome.tasksSucceeded += 1;
+    }
+    else if (status === 'failed' || status === 'blocked') {
+        if (tid) {
+            liveOutcome.failedTaskIds.add(String(tid));
+        }
+        liveOutcome.executorFailed = true;
+    }
+}
+const READ_DISCOVERY_TOOLS = new Set([
+    'read_file',
+    'grep',
+    'list_directory',
+    'glob',
+    'search_project',
+    'list_dir',
+    'dir',
+    'read',
+]);
+/** Track read/discovery tool usage for analysis-turn accountability. */
+export function noteAnalysisToolUse(toolName, liveOutcome) {
+    const normalized = String(toolName || '').trim().toLowerCase();
+    if (READ_DISCOVERY_TOOLS.has(normalized)) {
+        liveOutcome.analysisToolsUsed += 1;
+    }
+}
+/**
+ * Compute the real CLI success verdict.
+ * When tasks were planned, ALL must succeed — file changes alone never imply victory.
+ */
+export function evaluateExecutorSuccess(liveOutcome) {
+    const hasFatalError = liveOutcome.executorFailed
+        || Boolean(liveOutcome.plannerError)
+        || Boolean(liveOutcome.executorError);
+    if (hasFatalError && liveOutcome.tasksTotal === 0) {
+        return {
+            executorSucceeded: false,
+            statusHeadline: '✕ Execution Error',
+            uiTheme: 'error',
+        };
+    }
+    if (liveOutcome.tasksTotal > 0) {
+        const allTasksPassed = liveOutcome.tasksSucceeded === liveOutcome.tasksTotal;
+        const partialTasksPassed = liveOutcome.tasksSucceeded > 0;
+        const failedCount = liveOutcome.failedTaskIds.size;
+        if (allTasksPassed && !hasFatalError) {
+            return {
+                executorSucceeded: true,
+                statusHeadline: `✓ Agent run finished (${liveOutcome.tasksSucceeded}/${liveOutcome.tasksTotal} tasks completed)`,
+                uiTheme: 'success',
+            };
+        }
+        if (partialTasksPassed) {
+            return {
+                executorSucceeded: false,
+                statusHeadline: `⚠ Warning: Partial Run (${liveOutcome.tasksSucceeded}/${liveOutcome.tasksTotal} tasks completed${failedCount ? `, ${failedCount} failed` : ''})`,
+                uiTheme: 'warning',
+            };
+        }
+        return {
+            executorSucceeded: false,
+            statusHeadline: `✕ Failed: 0/${liveOutcome.tasksTotal} tasks completed${liveOutcome.changedFileCount > 0 ? ' (stub writes or stalls detected)' : ''}`,
+            uiTheme: 'error',
+        };
+    }
+    // Analysis / verification turns with no planned task graph
+    if (!liveOutcome.requiresWorkspaceChanges) {
+        const analysisOk = liveOutcome.analysisToolsUsed > 0 || liveOutcome.workspaceHasOutput;
+        if (!analysisOk && hasFatalError) {
+            return {
+                executorSucceeded: false,
+                statusHeadline: '✕ Analysis failed — no workspace evidence gathered',
+                uiTheme: 'error',
+            };
+        }
+        if (!analysisOk) {
+            return {
+                executorSucceeded: false,
+                statusHeadline: '⚠ Warning: No read tools confirmed — answer may be incomplete',
+                uiTheme: 'warning',
+            };
+        }
+        return {
+            executorSucceeded: true,
+            statusHeadline: '✓ Analysis completed',
+            uiTheme: 'success',
+        };
+    }
+    const legacySuccess = liveOutcome.workspaceHasOutput && liveOutcome.changedFileCount > 0;
+    return {
+        executorSucceeded: legacySuccess && !hasFatalError,
+        statusHeadline: legacySuccess && !hasFatalError
+            ? '✓ Agent run finished'
+            : '✕ No validated workspace output',
+        uiTheme: legacySuccess && !hasFatalError ? 'success' : 'error',
+    };
+}

package/dist/utils/api.d.ts

@@ -224,6 +224,11 @@ export declare class APIClient {
     private vigFlowTokens;
     private _httpsAgent;
     private lastChatTransportErrors;
+    private clientToolErrors;
+    private pendingV3ClientToolTasks;
+    /** Tracks files mutated via client_tool_request during an active V3 SSE stream. */
+    private activeV3StreamedFiles;
+    private activeV3StreamContext;
     constructor(config: Config, logger: Logger);
     /**
      * Destroy keep-alive sockets so the Node.js event loop can drain
@@ -253,6 +258,7 @@ export declare class APIClient {
     getV3AgentBaseUrls(preferLocal?: boolean): string[];
     getV3AgentRunUrl(baseUrl: string): string;
     getV3AgentContinueUrl(baseUrl: string): string;
+    getV3AgentBackgroundUrl(baseUrl: string, suffix?: string): string;
     getOperatorBaseUrls(): string[];
     getOperatorStreamUrl(baseUrl: string): string;
     getMcpBaseUrls(): string[];
@@ -328,6 +334,8 @@ export declare class APIClient {
      *   5. Drop readmeExcerpt
      */
     private compactV3Context;
+    /** Remove duplicate functionIndex entries that poison model context after compaction. */
+    private dedupeBrainPayload;
     buildMinimalV3AgentContext(context?: Record<string, any>): string;
     private extractEmergencyAppName;
     private materializeEmergencySaaSWorkspace;
@@ -355,6 +363,10 @@ export declare class APIClient {
     extractExpectedWorkspaceFiles(message?: string, context?: Record<string, any>): string[];
     captureV3AgentStreamMutation(event: any, streamedFiles: Record<string, string>, serverRoot?: string | null): void;
     private applyV3AgentStreamEventToWorkspace;
+    private resolveV3ClientToolPath;
+    private recordV3ClientToolMutation;
+    private executeV3ClientToolRequest;
+    private handleV3ClientToolRequest;
     private writeV3AgentWorkspaceFile;
     private deleteV3AgentWorkspaceFile;
     recoverAgentWorkspaceFiles(context?: Record<string, any>, streamedFiles?: Record<string, string>, expectedFiles?: string[]): void;
@@ -374,8 +386,25 @@ export declare class APIClient {
      */
     private synthesizeAnswerFromV3Events;
     private sanitizeV3AgentEventForUser;
+    private resolveAgentChangedFiles;
+    private finalizeV3AgentWorkflowResponse;
     collectV3AgentStream(response: Response, context?: Record<string, any>): Promise<any>;
     runV3AgentWorkflow(message: string, context?: Record<string, any>): Promise<V3AgentWorkflowResponse>;
+    startV3BackgroundJob(message: string, context?: Record<string, any>): Promise<any>;
+    listV3BackgroundJobs(limit?: number): Promise<any[]>;
+    getV3BackgroundJob(jobId: string): Promise<any>;
+    cancelV3BackgroundJob(jobId: string): Promise<any>;
+    getV3BackgroundJobFiles(jobId: string): Promise<{
+        status: string;
+        files: Record<string, string>;
+        file_count: number;
+        local_workspace_path?: string;
+    }>;
+    applyV3BackgroundJobFiles(jobId: string, context?: Record<string, any>): Promise<{
+        applied: string[];
+        skipped: string[];
+        status: string;
+    }>;
     private formatOperatorResponse;
     runOperatorWorkflow(message: string, context?: Record<string, any>): Promise<OperatorWorkflowResponse>;
     /**
@@ -515,6 +544,9 @@ export declare class APIClient {
     }>;
     mapPreflightEndpointToRoute(endpoint: string): ChatRoutePreference | null;
     getLastChatTransportErrors(): string[];
+    getClientToolErrors(): string[];
+    clearAgentRunDiagnostics(): void;
+    private recordClientToolError;
     submitClientToolResult(contextId: string, callId: string, result: {
         success: boolean;
         output: string;